Webpack 4.x搭建Vue脚手架踩坑记录

博主分享了在搭建Vue脚手架过程中遇到的问题及解决方案,包括版本不兼容、css分离、babel配置和webpack出入文件路径等关键点。

摘要生成于 C知道 ,由 DeepSeek-R1 满血版支持, 前往体验 >

博主最近在自己搭建一个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需要设置该虚拟路径目录保存才能正常使用。

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值