一、vue.config.js文件配置
在項(xiàng)目根目錄下自己手動新建
vue.config.js文件,會被@vue/cli-service自動加載。
參考的官方文檔
1、配合webpack的配置
簡單配置
調(diào)整webpack配置最簡單的方式就是在vue.config.js中的configureWebpack選項(xiàng)提供一個對象。該對象將會被webpack-merge合并如最終的webpack配置。
在configureWebpack里可以配置webpack的loader和plugins等
//vue.config.js
module.exports = {
//1.簡單配置
configureWebpack : {
plugins: [
new MyAwesomeWebpackPlugin(),
]
}
//2.鏈?zhǔn)讲僮鳎涸试S對內(nèi)部的webpack配置進(jìn)行更細(xì)粒度的修改
chainWebpack : config => {
}
//3.webpack的css的一些loader
css : {
module : false,
extract : false ,
sourceMap : false,
loaderOptions: { //向css相關(guān)的loader傳遞選項(xiàng),
//支持的loader:css-loader,postcss-loader,sass-loader,less-loader,stylus-loader
css : {
//這里的選項(xiàng)會傳遞給 css-loader
},
postcss : {
//這里的選項(xiàng)會傳遞給 postcss-loader
}
},
}
//4.所有webpack的devServer的選項(xiàng)都支持
devServer : {
proxy : {
'/api' : {
target : 'http://localhost:4000',
ws : true,
changeOrigin : true,
}
}
}
}
2.完整配置文件
下方配置項(xiàng)的值都是默認(rèn)值
//vue.config.js
module.exports = {
//1.從vue cli3.3開始已棄用,請使用publicPath
baseUrl : '/',
/*
2.1部署應(yīng)用包時的基本URL。用法和webpack本身的output.publicPath一致。
但在cli的其它地方也會用到這個值,所以請不要直接修改webpack的output.publicPath。
2.2默認(rèn)情況下,Vue Cli會假設(shè)你的應(yīng)用是被部署在一個域名的根路徑。
如我本地的應(yīng)用的路徑是“D:\WORK\study\vue\vue_cli3_test\demo1”,則在這個應(yīng)用中,根路徑就是“D:\WORK\study\vue\vue_cli3_test\demo1”
*/
publicPath : '/',
//3.當(dāng)運(yùn)行vue-cli-service build時生成的生產(chǎn)環(huán)境構(gòu)建環(huán)境的目錄。用法和webpack的output.path一樣,不要修改output.path
outputDir :'dist',
//4.放置打包后生成的靜態(tài)資源(js、css、img、fonts)的目錄,該目錄相對于outputDir。
assetsDir:' ',
//5.指定生成的index.html的輸出路徑,相對于outputDir。也可以是一個絕對路徑。
indexPath : 'index.html',
//6.
filenameHashing : true,
//7.多頁應(yīng)用模式下構(gòu)建應(yīng)用
pages : undefined,
//8.安裝@vue/cli-plugin-eslint后生效。為true時將檢查錯誤輸出為編譯警告輸出到命令行,編譯不會失敗。
//為"error"時,將檢查錯誤直接顯示在瀏覽器中。強(qiáng)制eslint-loader將lint錯誤輸出為編譯錯誤,編譯會失敗。
lintOnSave : true,
//9.
tuntimeCompiler : false,
//10.
transpileDependencies : [],
//11.如果你不需要生產(chǎn)環(huán)境的 source map,可以將其設(shè)置為 false 以加速生產(chǎn)環(huán)境構(gòu)建
productionSourceMap : true,
//12.
crossorigin : undefined,
//13.
integrity : false,
//14.
parallel : require('os').cpus().length > 1 ,
//15.向PWA插件傳遞選項(xiàng)
pwa : {}
//16.不進(jìn)行任何schema驗(yàn)證的對象,可以用來傳遞任何第三方插件選項(xiàng),不是webpack的plugins
pluginOptions : {},
//17.和wenpack相關(guān)的配置參考最上面代碼
}
1.eslint是用于檢查我們寫的javascript代碼是否滿足指定規(guī)則的
靜態(tài)代碼檢查工具,是使用nodejs寫的。
2.webpack的Source Map 使用
二、環(huán)境變量與模式
1.為什么需要自定義配置環(huán)境變量和模式?
一個項(xiàng)目前端開發(fā)過程中,一般會經(jīng)歷本地開發(fā),測試腳本, 開發(fā)自測 ,測試環(huán)境 ,預(yù)上線環(huán)境 才能正式發(fā)布。對應(yīng)每個環(huán)境都可能有所差異,如 服務(wù)器地址,后臺接口地址等。所以在環(huán)境切換時,就需要不同的配置參數(shù),這時候就可以使用環(huán)境變量和模式,來方便我們管理。
2.vue-cli3總共提供了四中方式來指定環(huán)境變量:
1.在根目錄添加.env文件,配置所有情況下都會用到的配置(不知道這個存在的意義,所有的都需要的也就不需要配置了吧)。
2.在根目錄添加.env.local文件,配置所有情況下都會用到的配置,與.env的區(qū)別是只會在本地,該文件不會被git跟蹤。
3.在根目錄添加.env.[mode]文件,配置對應(yīng)某個模式下的配置,比如:.env.development來配置開發(fā)環(huán)境的配置。
4.在根目錄添加.env.[mode].local文件,配置對應(yīng)某個模式下的配置,與.env.[mode]的區(qū)別也只是會在本地生效,該文件不會被git跟蹤。
3.模式
在運(yùn)行命令時為
NODE_ENV賦值,去設(shè)置此時運(yùn)行的應(yīng)用的環(huán)境模式。每個模式都會將NODE_ENV的值設(shè)置為模式的名稱——比如在 development 模式下 NODE_ENV 的值會被設(shè)置為 "development"
默認(rèn)情況下Vue Cli項(xiàng)目有三種模式,
- development:在vue-cli-service serve下,即開發(fā)環(huán)境使用
- production:在vue-cli-service build 和vue-cli-service test:e2e下,即正式環(huán)境使用
- test: 在vue-cli-service test:unit下使用
在package.json文件中:
{
"scripts": {
"serve": "vue-cli-service serve", // vue-cli-service serve --mode development,不帶mode參時默認(rèn)是開發(fā)環(huán)境
"build": "vue-cli-service build", // vue-cli-service build --mode production,不帶mode參時默認(rèn)是生產(chǎn)環(huán)境
"lint": "vue-cli-service lint",
//自己新建一個模式:需要在項(xiàng)目根目錄新建.env.stage1文件,在.env.stage1文件里聲明變量
//會在 stage1 模式下加載可能存在的 .env、.env.stage1 和 .env.stage1.local 文件然后構(gòu)建出生產(chǎn)環(huán)境應(yīng)用。
"stage1" :"vue-cli-service serve --mode stage1"
},
}
環(huán)境加載優(yōu)先級
為一個特定模式準(zhǔn)備的環(huán)境文件將會比一般的環(huán)境文件擁有更改的優(yōu)先級。
同一個key:.env.[mode].local>.env.[mode]>.env
4.環(huán)境變量
在
.env文件中,只有以VUE_APP_開頭的變量會被webpack.DefinePlugin靜態(tài)嵌入到客戶端側(cè)的包中。環(huán)境變量必須以VUE_APP_開頭。
//.env文件
VUE_APP_SECRET = secret
//js文件訪問
console.log(process.env.VUE_APP_SECRET)
5.示例
1.設(shè)置環(huán)境變量
.env文件:VUE_APP_NAME = commom
.env.development文件:VUE_APP_NAME = com_development
.env.production文件:VUE_APP_NAME = com_production
.env.development.local文件:VUE_APP_NAME = com_development_local
2.package.json文件
{
"scripts": {
"serve": "vue-cli-service serve",
"build": "vue-cli-service build",
"stage1" :"vue-cli-service serve --mode stage1"
},
}
3.在項(xiàng)目
main.js里輸出console.log(process.env.VUE_APP_NAME)
4.運(yùn)行應(yīng)用
1.使用命令:npm run serve
該命令默認(rèn)develpoment模式,會加載可能存在的.env,.env.development,.env.development.local文件。
輸出com_development_local
2.使用命令:npm run build
該命令默認(rèn)production模式,會加載可能存在的.env,.env.production,.env.production.local文件。
輸出com_production
3..使用命令:npm run stage1
該命令默認(rèn)production模式,會加載可能存在的.env,.env.stage1,.env.stage1.local文件。
輸出common
未完待續(xù)......