1.啥是vu.config.js
Vue-cli2還有build目錄，包含了webpack.base.config.js、webpack.dev.config.js 、webpack.prod.config.js 等配置文件，而vue-cli3學習rollup的零配置思路，項目初始化以后沒有build目錄，也沒有了配置文件。如果我們想做一些相關的配置，需要創建一個vue.config.js來進行數據修改，代理啥的配置。
2.配置詳解
vue.config.js文件是一個可選配置文件，存放於根目錄，@vue/cli-service啟動的時候自動加載。對於一些腳本的配置(環境變量、啟動、構建等)可以使用package.json來進行配置。
里面內容大致如下
其他的一條條配置進去就可以
publicPath
{
Type(類型): string
Default(默認): '/'
}
1.項目部署的基礎路徑
2.我們默認假設你的應用將會部署在域名的根部，
3.比如 https://www.my-app.com/
4.如果你的應用時部署在一個子路徑下，那么你需要在這里
指定子路徑。比如，如果你的應用部署在
https://www.foobar.com/my-app/
那么將這個值改為 `/my-app/`
拓展：把開發服務器假設在根路徑，可以直接使用一個判斷
publicPath :process.env.NODE_ENV === 'production' ? '/production-sub-path/' : '/'
outputDir (基本不動，打包目錄不都是用那個嗎)
{
Type(類型): string
Default(默認): 'dist'
}
1.將構建好的文件輸出到哪里（或者說將編譯的文件），當運行 vue-cli-service build 時生成的生產環境構建文件的目錄。注意目標目錄在構建之前會被清除 (構建時傳入 --no-clean 可關閉該行為)
outputDir: 'dist'
assetsDir (基本上都是默認)
{
Type(類型): string
Default(默認): ''
}
1.放置生成的靜態資源 (js、css、img、fonts) 的目錄，即打包以后存放靜態資源的目錄
assetsDir: 'static'
indexPath (沒動過)
{
Type(類型): string
Default(默認): 'index.html'
}
1.指定生成的 index.html 的輸出路徑 (相對於 outputDir)。也可以是一個絕對路徑。
filenameHashing (默認就行)
{
Type(類型): boolean
Default(默認): true
}
1默認情況下，生成的靜態資源在它們的文件名中包含了 hash 以便更好的控制緩存。然而，這也要求 index 的 HTML 是被 Vue CLI 自動生成的。如果你無法使用 Vue CLI 生成的 index HTML，你可以通過將這個選項設為 false 來關閉文件名哈希。
注意：這個是比較重要的有延伸，vue感覺上側重於單頁面應用，意思就是只有一個頁面，里面的操作都是通過組件的切換來完成的但是你也可以使用多頁面
單頁面應用(spa)
概念：只有一個html頁面，所有跳轉方式都是通過組件切換完成的。 優點：頁面之間跳轉流暢、組件化開發、組件可復用、開發便捷、易維護。 缺點：首屏加載較慢，加載整個項目中使用的css、js，SEO優化不好。
多頁面應用(mpa)
概念：整個項目有多個html，所有跳轉方式都是頁面之間相互跳轉的。 優點：首屏加載較快，只加載本頁所使用的的css、js，SEO優化較好。 缺點：頁面跳轉較慢。(參考：https://www.jianshu.com/p/52c4913e0bf4)
pages
{
Type(類型): Object
Default(默認): undefined
}
1.在 multi-page（多頁）模式下構建應用。每個“page”應該有一個對應的 JavaScript 入口文件。
舉例子：
// 用於多頁配置，默認是 undefined
pages: {
index: {
// 入口文件
entry: 'src/main.js', /*這個是根入口文件*/
// 模板文件
template: 'public/index.html',
// 輸出文件
filename: 'index.html',
// 頁面title
title: 'Index Page'
},
// 簡寫格式
// 模板文件默認是 `public/subpage.html`
// 如果不存在，就是 `public/index.html`.
// 輸出文件默認是 `subpage.html`.
subpage: 'src/main.js' /*注意這個是*/
},
lintOnSave (默認)
{
Type(類型): boolean | 'error'
Default(默認): true
}
1. 是否在保存的時候使用 `eslint-loader` 進行檢查。 有效的值：`ture` | `false` | `"error"` 當設置為 `"error"` 時，檢查出的錯誤會觸發編譯失敗。
lintOnSave: true
runtimeCompiler (默認 我沒用過)
{
Type(類型): boolean
Default(默認): false
}
1. 是否使用帶有瀏覽器內編譯器的完整構建版本
2. 設置為 true 后你就可以在 Vue 組件中使用 template 選項了，
但是這會讓你的應用額外增加 10kb 左右。
transpileDependencies (沒用過)
{
Type(類型): Array<string | RegExp>
Default(默認): []
}
1. 默認情況下 babel-loader 會忽略所有 node_modules 中的文件。
2. 如果你想要通過 Babel 顯式轉譯一個依賴，可以在這個選項中列出來
3. babel-loader 默認會跳過 node_modules 依賴。
4. 通過這個選項可以顯式轉譯一個依賴。
productionSourceMap (就只是知道這么個意思)
{
Type(類型): boolean
Default(默認): true
}
1. 如果你不需要生產環境的 source map，可以將其設置為 false 以加速生產環境構建。
productionSourceMap: false
crossorigin (不知道)
{
Type(類型): string
Default(默認): undefined
}
1.在生成的 HTML 中的 <link rel="stylesheet"> 和 <script> 標簽上啟用 Subresource Integrity
(SRI)。如果你構建后的文件是部署在 CDN 上的，啟用該選項可以提供額外的安全性。
Webpack相關配置
configureWebpack
Type:Object | Function
1.如果這個值是一個對象，則會通過 webpack-merge 合並到最終的配置中。
2.如果這個值是一個函數，則會接收被解析的配置作為參數。
該函數及可以修改配置並不返回任何東西，也可以返回一個被克隆或合並過的配置版本。
chainWebpack
Type: Function
1.是一個函數，會接收一個基於 webpack-chain 的 ChainableConfig 實例。
允許對內部的 webpack 配置進行更細粒度的修改。
eg.
configureWebpack: {
// provide the app's title in webpack's name field, so that
// it can be accessed in index.html to inject the correct title.
name: name,
resolve: {
alias: {
'@': resolve('src')
}
}
},
chainWebpack(config) {
// it can improve the speed of the first screen, it is recommended to turn on preload
// it can improve the speed of the first screen, it is recommended to turn on preload
config.plugin('preload').tap(() => [
{
rel: 'preload',
// to ignore runtime.js
// https://github.com/vuejs/vue-cli/blob/dev/packages/@vue/cli-service/lib/config/app.js#L171
fileBlacklist: [/\.map$/, /hot-update\.js$/, /runtime\..*\.js$/],
include: 'initial'
}
])
// when there are many pages, it will cause too many meaningless requests
config.plugins.delete('prefetch')
// set svg-sprite-loader
config.module
.rule('svg')
.exclude.add(resolve('src/icons'))
.end()
config.module
.rule('icons')
.test(/\.svg$/)
.include.add(resolve('src/icons'))
.end()
.use('svg-sprite-loader')
.loader('svg-sprite-loader')
.options({
symbolId: 'icon-[name]'
})
.end()
config
.when(process.env.NODE_ENV !== 'development',
config => {
config
.plugin('ScriptExtHtmlWebpackPlugin')
.after('html')
.use('script-ext-html-webpack-plugin', [{
// `runtime` must same as runtimeChunk name. default is `runtime`
inline: /runtime\..*\.js$/
}])
.end()
config
.optimization.splitChunks({
chunks: 'all',
cacheGroups: {
libs: {
name: 'chunk-libs',
test: /[\\/]node_modules[\\/]/,
priority: 10,
chunks: 'initial' // only package third parties that are initially dependent
},
elementUI: {
name: 'chunk-elementUI', // split elementUI into a single package
priority: 20, // the weight needs to be larger than libs and app or it will be packaged into libs or app
test: /[\\/]node_modules[\\/]_?element-ui(.*)/ // in order to adapt to cnpm
},
commons: {
name: 'chunk-commons',
test: resolve('src/components'), // can customize your rules
minChunks: 3, // minimum common number
priority: 5,
reuseExistingChunk: true
}
}
})
// https:// webpack.js.org/configuration/optimization/#optimizationruntimechunk
config.optimization.runtimeChunk('single')
}
)
}
Css相關配置
// CSS 相關選項
css: {
extract: true,
Type: boolean | Object
1. 將組件內的 CSS 提取到一個單獨的 CSS 文件 (只用在生產環境中)
2. 也可以是一個傳遞給 `extract-text-webpack-plugin` 的選項對象
sourceMap: false,
{
Type(類型): boolean
Default(默認): false
}
1. 是否開啟 CSS source map？ 設置為 true 之后可能會影響構建的性能。
loaderOptions: {},
{
Type(類型): Object
Default(默認): {}
}
1. 為預處理器的 loader 傳遞自定義選項。比如傳遞給sass-loader 時，使用 `{ sass: { ... } }`。
modules: false
{
Type(類型): boolean
Default(默認): false
}
1.為所有的 CSS 及其預處理文件開啟 CSS Modules。
2. 這個選項不會影響 `*.vue` 文件。
},
// 在生產環境下為 Babel 和 TypeScript 使用 `thread-loader`
// 在多核機器下會默認開啟。
parallel: require('os').cpus().length > 1,
// PWA 插件的選項。
// 查閱 https://github.com/vuejs/vue-cli/tree/dev/packages/@vue/cli-plugin-pwa
pwa: {},
代理配置
//如果你的前端應用和后端 API 服務器沒有運行在同一個主機上，
//你需要在開發環境下將 API 請求代理到 API 服務器。
//這個問題可以通過 vue.config.js 中的 devServer.proxy 選項來配置。
//配置 webpack-dev-server 行為。
devServer: {
open: process.platform === 'darwin',
host: '0.0.0.0',
port: 8080,
https: false,
hotOnly: false,
proxy: {
'/api': {
target: 'http://localhost:8880',
changeOrigin: true,
secure: false,
// ws: true,
pathRewrite: {
'^/api': '/static/mock'
// 請求數據路徑別名,這里是注意將static/mock放入public文件夾
}
}
},
before: app => {}
},
簡潔版
module.exports = {
// publicPath:process.env.NODE_ENV === 'production' ? '/vue_workspac/aihuhuproject/' : '/',
//基本路徑
publicPath: './',//默認的'/'是絕對路徑，如果不確定在根路徑，改成相對路徑'./'
// 輸出文件目錄
outputDir: 'dist',
assetsDir: 'static',
indexPath: 'index.html',
// eslint-loader 是否在保存的時候檢查
lintOnSave: true,
// 生產環境是否生成 sourceMap 文件
productionSourceMap: false,
// css相關配置
css: {
// 是否使用css分離插件 ExtractTextPlugin
extract: true,
// 開啟 CSS source maps?
sourceMap: false,
},
// webpack-dev-server 相關配置
devServer: {
open: false,//open 在devServer啟動且第一次構建完成時，自動用我們的系統的默認瀏覽器去打開要開發的網頁
host: '0.0.0.0',//默認是 localhost。如果你希望服務器外部可訪問，指定如下 host: '0.0.0.0'，設置之后之后可以訪問ip地址
port: 8080,
hot: true,//hot配置是否啟用模塊的熱替換功能，devServer的默認行為是在發現源代碼被變更后，通過自動刷新整個頁面來做到事實預覽，開啟hot后，將在不刷新整個頁面的情況下通過新模塊替換老模塊來做到實時預覽。
https: false,
hotOnly: false,// hot 和 hotOnly 的區別是在某些模塊不支持熱更新的情況下，前者會自動刷新頁面，后者不會刷新頁面，而是在控制台輸出熱更新失敗
proxy: {
'/': {
target: 'http://xxxx:8080', //目標接口域名
secure: false, //false為http訪問，true為https訪問
changeOrigin: true, //是否跨域
pathRewrite: {
'^/': '/' //重寫接口
}
}
}, // 設置代理
before: app => { }
},
// 第三方插件配置
pluginOptions: {
// ...
}
};
參考:
1.