尤雨溪:Vue 3.0 計(jì)劃 原文需翻墻
尤雨溪:Vue 3.0 計(jì)劃 掘金譯文
關(guān)于安裝
Vue CLI 的包名稱(chēng)由 vue-cli 改成了 @vue/cli
npm install -g @vue/cli
安裝完成后查看版本
vue --V
項(xiàng)目創(chuàng)建
關(guān)于項(xiàng)目創(chuàng)建终娃,除了命令創(chuàng)建3.x還增加了圖形化界面創(chuàng)建以及管理vue項(xiàng)目
在創(chuàng)建新項(xiàng)目時(shí)還可以混合選用多種集成
- TypeScript
- PWA
- Vue Router & Vuex
- ESLint / TSLint / Prettier
- 用 Jest 或 Mocha 進(jìn)行單元測(cè)試
- 用 Cypress 或者 Nightwatch 進(jìn)行 E2E 測(cè)試
使用命令創(chuàng)建
命令:vue create vueapp
1、使用上下箭頭選擇默認(rèn)設(shè)置還是手動(dòng)選擇功能
Vue CLI v3.0.3
? Please pick a preset:
default (babel, eslint)
> Manually select features
2蒸甜、按空格鍵選擇你需要的功能棠耕,選完后按回車(chē)
babel:javascript轉(zhuǎn)譯器,將最新版的js語(yǔ)法(es6柠新、es7)轉(zhuǎn)換為現(xiàn)階段瀏覽器可以兼容的js代碼
typescript:使用 TypeScript 書(shū)寫(xiě)源碼
PWA:漸進(jìn)式WEB應(yīng)用
Router:使用vue-router
Vuex:使用vuex
CSS Pre-processors:css預(yù)處理器
Linter / Formatter:代碼規(guī)范標(biāo)準(zhǔn)
Unit Testing:?jiǎn)卧獪y(cè)試
E2E Testing:e2e測(cè)試
Vue CLI v3.0.3
? Please pick a preset: Manually select features
? Check the features needed for your project:
(*) Babel
( ) TypeScript
( ) Progressive Web App (PWA) Support
(*) Router
(*) Vuex
>(*) CSS Pre-processors
(*) Linter / Formatter
( ) Unit Testing
( ) E2E Testing
3窍荧、router是否使用history模式蕊退,history需要服務(wù)器支持詳程梦,情請(qǐng)看這兒https://router.vuejs.org/zh/guide/essentials/history-mode.html
這里我就選no
4衣厘、css預(yù)處理器的選擇压恒,我習(xí)慣用sass
5妆兑、代碼格式化檢測(cè)選擇腺逛,我用的是ide是vscode個(gè)人感覺(jué)搭配插件用著很舒服,所以我選Prettier
6厌小、是否保存剛才的配置,下一次就不用重新配置了罪治,我就直接回車(chē)
7丽声、關(guān)于Babel, PostCSS, ESLint, etc.這些配置文件你是想放在package.json里面還是單獨(dú)放在外面
編輯器一般默認(rèn)會(huì)在項(xiàng)目根目錄下尋找配置文件,這里我就直接回車(chē)選擇In dedicated config files
8觉义、是否保存為未來(lái)項(xiàng)目的預(yù)配置嗎雁社,我也是直接回車(chē)
最后配置如下
Vue CLI v3.0.3
? Please pick a preset: Manually select features
? Check the features needed for your project: Babel, Router, Vuex, CSS Pre-processors, Linter
? Use history mode for router? (Requires proper server setup for index fallback in production) No
? Pick a CSS pre-processor (PostCSS, Autoprefixer and CSS Modules are supported by default): Sass/SCSS
? Pick a linter / formatter config: Prettier
? Pick additional lint features: Lint on save
? Where do you prefer placing config for Babel, PostCSS, ESLint, etc.? In dedicated config files
? Save this as a preset for future projects? Yes
圖形化界面
圖形化操作非常方便,我就不一步步演示了晒骇,主要懶得貼圖 (°ー°〃)
執(zhí)行npm命令
vue ui
訪問(wèn) http://localhost:8000 你就可以創(chuàng)建霉撵,管理磺浙,導(dǎo)入項(xiàng)目
實(shí)用新功能
- node_modules
- public
- src
- .browserslistrc
- .eslintrc.js
- .gitignore
- babel.config.js
- package.json
- postcss.config.js
- README.md
以上是項(xiàng)目根目錄,3.x對(duì)比2.x文件結(jié)構(gòu)明顯精簡(jiǎn)了不少徒坡,多了一個(gè)public文件夾用于存放靜態(tài)文件少了config撕氧、build等一系列的配置文件,這些配置文件都被放在了node_modules@vue文件下
browserslist
根目錄中多了一個(gè).browserslist文件喇完,可以指定項(xiàng)目的目標(biāo)瀏覽器的范圍
用于轉(zhuǎn)譯的 JavaScript 特性和添加CSS 瀏覽器前綴呵曹,可以減少兼容代碼提高代碼質(zhì)量
如果想少一個(gè)文件,你也可以在package.json中添加browserslist字段何暮,參數(shù)是一個(gè)數(shù)組
這是默認(rèn)設(shè)置奄喂,兼容所有最新版本,不支持ie8以下
> 1%
last 2 versions
not ie <= 8
使用 npx browserslist 可以查看項(xiàng)目的瀏覽器兼容情況
將需要支持的目標(biāo)瀏覽器參數(shù)放在文件中就好
參數(shù) | 說(shuō)明 |
---|---|
> 1% | 全球超過(guò)1%人使用的瀏覽器 |
> 5% in US | 使用美國(guó)使用情況統(tǒng)計(jì)海洼,接受兩個(gè)字母的國(guó)家/地區(qū)代碼 |
> 5% in my stats | 使用自定義使用數(shù)據(jù) |
last 2 versions | 所有瀏覽器兼容到最后兩個(gè)版本根據(jù)CanIUse.com追蹤的版本 |
Firefox ESR | 火狐最新版本 |
Firefox > 20 | 指定版本范圍 |
not ie <=8 | 方向排除部分版本 |
Firefox 12.1 | 指定瀏覽器版本 |
since 2013 | 2013年之后發(fā)布的所有版本 |
更多請(qǐng)查看官方文檔
vue-cli服務(wù)
在一個(gè) Vue CLI 項(xiàng)目中坏逢,@vue/cli-service 安裝了一個(gè)名為 vue-cli-service 的命令。
你可以在 npm scripts 中以 vue-cli-service是整、或者從終端中以 ./node_modules/.bin/vue-cli-service 訪問(wèn)這個(gè)命令
Vue CLI 項(xiàng)目有三個(gè)模式: development 模式用于啟動(dòng)肖揣,production 模式用于打包和e2e測(cè)試,test 模式用于unit測(cè)試
啟動(dòng)
serve:vue-cli-service serve
--open 在服務(wù)器啟動(dòng)時(shí)打開(kāi)瀏覽器
--copy 在服務(wù)器啟動(dòng)時(shí)將 URL 復(fù)制到剪切版
--mode 指定環(huán)境模式 (默認(rèn)值:development)
--host 指定 host (默認(rèn)值:0.0.0.0)
--port 指定 port (默認(rèn)值:8080)
--https 使用 https (默認(rèn)值:false)
打包
build:vue-cli-service build
--modern 使用現(xiàn)代模式構(gòu)建應(yīng)用龙优,為現(xiàn)代瀏覽器交付原生支持的 ES2015 代碼事秀,并生成一個(gè)兼容老瀏覽器的包用來(lái)自動(dòng)回退彤断。
--target 允許你將項(xiàng)目中的任何組件以一個(gè)庫(kù)或 Web Components 組件的方式進(jìn)行構(gòu)建。更多細(xì)節(jié)請(qǐng)查閱構(gòu)建目標(biāo)易迹。
--report 和 --report-json 會(huì)根據(jù)構(gòu)建統(tǒng)計(jì)生成報(bào)告宰衙,它會(huì)幫助你分析包中包含的模塊們的大小
測(cè)試
test: vue-cli-service test:e2e 端到端測(cè)試
vue-cli-service test:unit 單元測(cè)試
現(xiàn)代模式
為了兼容那些不支持js新特性的瀏覽器我們需要Babel轉(zhuǎn)譯睹欲,但轉(zhuǎn)譯后的代碼笨重冗長(zhǎng),這次3.x提供了一個(gè)現(xiàn)代模式
npx vue-cli-service build --modern
這個(gè)命令會(huì)產(chǎn)生兩個(gè)應(yīng)用的版本:一個(gè)現(xiàn)代版的包窘疮,面向支持 ES modules 的現(xiàn)代瀏覽器考余,另一個(gè)舊版的包,面向不支持的舊瀏覽器
而且不需要我們手動(dòng)去部署和設(shè)置什么楚堤,簡(jiǎn)直很貼心
- 現(xiàn)代版的包會(huì)通過(guò)
<script type="module">
在被支持的瀏覽器中加載含懊;它們還會(huì)使用<link rel="modulepreload">
進(jìn)行預(yù)加載 - 舊版的包會(huì)通過(guò)
<script nomodule>
加載衅胀,并會(huì)被支持 ES modules 的瀏覽器忽略 - 一個(gè)針對(duì) Safari 10 中
<script nomodule>
的修復(fù)會(huì)被自動(dòng)注入
插件的添加
在一個(gè)已經(jīng)被創(chuàng)建好的項(xiàng)目中安裝一個(gè)插件,使用vue add命令
CLI 插件安裝
每個(gè) CLI 插件都會(huì)包含一個(gè) (用來(lái)創(chuàng)建文件的) 生成器和一個(gè) (用來(lái)調(diào)整 webpack 核心配置和注入命令的) 運(yùn)行時(shí)插件
對(duì)于這種cli插件需要加入@vue的前綴,這個(gè)命令將 @vue/eslint 解析為完整的包名 @vue/cli-plugin-eslint雏门,然后從 npm 安裝它掸掏,調(diào)用它的生成器
插件添加
vue add @vue/eslint
向被安裝的插件傳遞生成器選項(xiàng) (這樣做會(huì)跳過(guò)命令提示)
vue add @vue/eslint --config airbnb --lintOn save
第三方插件安裝
安裝并調(diào)用 vue-cli-plugin-apollo,不帶 @vue 前綴募闲,該命令會(huì)換作解析一個(gè) unscoped 的包
執(zhí)行此命令后src里會(huì)創(chuàng)建一個(gè)plugins文件夾愿待,里面會(huì)自動(dòng)生成關(guān)于插件的配置文件
vue add axios
基于一個(gè)指定的 scope 使用第三方插件,如果一個(gè)插件名為 @foo/vue-cli-plugin-bar要出,你可以這樣添加它:
vue add @foo/bar
配置修改
例:向所有 Sass 樣式傳入共享的全局變量
在根目錄新建一個(gè)vue.config.js农渊,加入以下配置
module.exports = {
css: {
loaderOptions: {
// 給 sass-loader 傳遞選項(xiàng)
sass: {
// @/ 是 src/ 的別名
// 所以這里假設(shè)你有 `src/variables.scss` 這個(gè)文件
data: `@import "@/variables.scss";`
}
}
}
}
打包后路徑問(wèn)題
在vue.config.js文件中加入'baseUrl: './''
module.exports = {
//...
baseUrl: './'
//...
}
雖然官方說(shuō)這個(gè)文件會(huì)被 @vue/cli-service 自動(dòng)加載,但如果你啟動(dòng)項(xiàng)目用的是npm run serve况脆,那么你最好使用npx vue-cli-service serve重啟一下
參考文章
官方文檔 https://cli.vuejs.org/zh/guide/
browserslist的github https://github.com/browserslist/browserslist
https://mp.weixin.qq.com/s/hfr2Q3FXZFIdqM_r8HrLwQ
歡迎留言交流 (′▽`???)