博主最近在自己搭建一個vue的腳手架,因爲感覺之前直接使用官方vue-cli之後,對於Webpack的使用不太熟悉,加上vue-cli3.0版本把webpack.config.js配置文件置換成自己的配置文件了之後,對於Webpack的使用就更加不熟練了。這裏總結一下搭建時遇到的坑,謹防再犯錯吧。
版本不兼容問題
博主使用的webpack版本號爲 4.25.1,對於npm install默認安裝的一些loader等都有不兼容的可能,如果同爲4.x版本的可以按以下版本號爲參考進行安裝,避免不必要的問題。
"dependencies": {
"vue": "^2.5.17"
},
"devDependencies": {
"babel": "^6.23.0",
"babel-core": "^6.26.3",
"babel-loader": "^7.1.4",
"babel-plugin-transform-runtime": "^6.23.0",
"babel-preset-es2015": "^6.24.1",
"babel-runtime": "^6.26.0",
"css-loader": "^1.0.1",
"file-loader": "^2.0.0",
"mini-css-extract-plugin": "^0.4.4",
"style-loader": "^0.23.1",
"url-loader": "^1.1.2",
"vue-hot-reload-api": "^2.3.1",
"vue-loader": "^15.4.2",
"vue-router": "^3.0.1",
"vue-style-loader": "^4.1.2",
"vue-template-compiler": "^2.5.17",
"webpack": "^4.25.1",
"webpack-cli": "^3.1.2",
"webpack-dev-server": "^3.1.10"
}
css分離
在3.0以及之前版本,css分離通常使用extract-text-webpack-plugin插件,但在4.0版本會報出版本不匹配的錯誤,這是因爲4.x版本的webpack捨棄了該插件轉而使用mini-css-extract-plugin插件,刪除原有的extract-text-webpack-plugin插件,重新安裝mini-css-extract-plugin插件即可解決問題。
具體配置如下
const MiniCssExtractPlugin = require("mini-css-extract-plugin");
const path = require('path');
var config={
//入口文件的配置項
entry:'./src/main.js',
//出口文件的配置項
output:{
//輸出的路徑,用了Node語法
path:path.resolve(__dirname,'dist'),
publicPath:"/dist/",
//輸出的文件名稱
filename:'build.js'
},
//模塊:例如解讀CSS,圖片如何轉換,壓縮
module:{
rules: [
{
test: /\.css$/,
use: [
MiniCssExtractPlugin.loader,
"css-loader"
]
}
]
},
//插件,用於生產模版和各項功能
plugins:[
new MiniCssExtractPlugin({
// Options similar to the same options in webpackOptions.output
// both options are optional
filename: "[name].css",
chunkFilename: "[id].css"
})
],
//配置webpack開發服務功能
devServer:{}
};
module.exports=config;
接下來是babel的版本問題
"babel-loader": "^7.1.4",
8.0以上版本可能也會有不兼容的問題。
webpack出入口文件的路徑問題
無論哪個版本的webpack,出入口文件路徑都要注意,入口文件使用相對路徑而出口文件只能使用絕對路徑。
//入口文件的配置項
entry:'./src/main.js',
//出口文件的配置項
output:{
//輸出的路徑,用了Node語法
path:path.resolve(__dirname,'dist'),
publicPath:"/dist/",
//輸出的文件名稱
filename:'build.js'
},
另外注意 publicPath:"/dist/",設置,當你使用 npm run serve/npm run dev需要設置該虛擬路徑目錄保存才能正常使用。