一、安裝 @vue/cli
更新到 3.x 之後,vue-cli 的包名從vue-cli
改成了 @vue/cli
如果之前全局安裝了舊版本的vue-cli (1.x 或 2.x)
,首先需要使用以下命令卸載掉
// 如果沒有安裝舊版本的 vue-cli 可以跳過卸載直接安裝
npm uninstall vue-cli -g
# OR
yarn global remove vue-cli
然後重新安裝新版本的 @vue/cli
npm install -g @vue/cli
# OR
yarn global add @vue/cli
安裝完成後,可以使用 vue -V
(這個 V 是大寫的)查看版本號
二、創建項目的三種方式
1.x
和 2.x
的vue-cli
採用 init 命令創建項目
vue init webpack project-name
3.x
也支持這種方式,其運行結果和以前一樣,
但剛入行的前端萌新可能還不習慣命令行的構建方式
於是 vue/cli 3.x
新增了圖形化的方式來創建項目
首先還是得在指定目錄下打開終端,然後運行:
vue ui
然後瀏覽器會打開一個頁面,可以按照頁面將的引導創建項目
不過我還是建議使用命令行工具,這才符合一個程序員的身份嘛
vue create project-name
這裏的 project-name
是自定義的項目名稱,命令執行之後,會生成對應文件夾
三、參數詳解
使用 create
命令創建項目的時候,有很多配置項需要選擇
如果對某項配置項不熟悉,可以直接選擇第一個選項
首先需要選擇模塊
如果選擇默認選項 default
,將會構建一個最基本的 vue 項目(沒有 vue-router 也沒有 vuex)
這裏推薦選擇第二項Manually select features
然後根據自己的需求,使用空格鍵選擇具體的模塊
如果不熟悉上面的模塊分別代表什麼,可以先按照上圖的示意勾選模塊
這樣就會創建一個包含vue-router
、vuex
和 postcss
的項目
勾選之後,使用回車鍵進入下一步
這裏需要選擇路由模式,yes 是 history
模式,no 是 hash
模式
萌新可以先從 hash 模式入手,不過實際項目通常採用 history 模式
然後選擇一個合適CSS
的預編譯工具
都不熟悉的話就選 sass
或者 less
,因爲 stylus
不支持原生CSS
寫法
後面還需要選擇ESLint
的校驗規則,格式化的時機,和各個插件的配置項的位置,不熟悉的話就選第一個
然後就有了這樣的過程:
最後選擇是否將配置項保存爲預設,然後配置完成,開始生成項目
項目生成之後,已經自動安裝了相關的依賴項,這時候可以直接啓動項目:
npm run serve
四、vue.config.js
完成以上步驟之後,就已經可以開發vue
項目了,但無法滿足定製化的開發需求
這時候就需要手動創建一個 vue.config.js
,官方的配置文檔可以參考這裏
這裏我貼一個常用的vue.config.js
// vue.config.js
module.exports = {
baseUrl: '/',
outputDir: 'dist', // 打包的目錄
lintOnSave: true, // 在保存時校驗格式
productionSourceMap: false, // 生產環境是否生成 SourceMap
devServer: {
open: true, // 啓動服務後是否打開瀏覽器
host: '0.0.0.0',
port: 8080, // 服務端口
https: false,
hotOnly: false,
proxy: null, // 設置代理
before: app => {}
},
}
vue.config.js
還有很多很厲害的配置項
比如構建多頁面應用的 pages
、*改造爲 pwa
* 的配置項 pwa
、高級CSS
打包方案 css
這裏就不細說了,如果有興趣可以仔細研究官方文檔
五、環境變量
有過一定開發經驗的小夥伴都知道,一個項目通常有三種模式:
開發模式 development
、測試模式 test
、生產模式 production
而開發中通常會根據環境變量 NODE_ENV 來進行區分這三種開發模式
然後通過很多的switch... case
來判斷
而 3.x
的項目中就不需要寫switch...case
了
直接在根目錄下創建以.env
爲前綴的文件
這裏的.env
文件保存的是公用參數,可以在所有模式中獲取到
而其他文件中的參數,只能在對應模式中獲取到
比如 .env.development
中的參數,就只有在development
模式下生效
然後在文件內添加對應的鍵值對
然後在 package.json
的 scripts 命令中添加對應的mode
// serve
、bulid
都有默認的模式,但最好是將模式顯式的展現在配置項中
然後就能在項目中獲取到對應模式下的值
關於環境變量和模式的詳情,可以參考官方文檔