内容摘要：webpack的安装比大多数人想象中要简单，但也比很多人期望的要复杂。说它简单，是因为核心步骤就两条命令；说它复杂，是因为你总会在版本冲突和环境变量上栽跟头。 先装Node.js，这是前提。webpa

webpack的载安装安装比大多数人想象中要简单，但也比很多人期望的载安装要复杂。说它简单，载安装是载安装因为核心步骤就两条命令；说它复杂，是载安装因为你总会在版本冲突和环境变量上栽跟头。

先装Node.js，载安装这是载安装前提。webpack跑在Node环境上，载安装没有它一切免谈。载安装去官网下载LTS版本，载安装一路下一步装完就行。载安装装完后打开终端，载安装输入node -v和npm -v，载安装能看到版本号就说明基础环境没问题。载安装我见过有人卡在这一步，载安装一查是PATH没配好，Windows用户尤其容易遇到。

接着建项目文件夹。别在桌面乱建，找个正经地方，比如D:\projects\my-app。进入这个目录，执行npm init -y，它会自动生成一个package.json文件。这个文件就是项目的身份证，后面所有依赖都记录在里面。

现在装webpack本体。我推荐局部安装而不是全局安装，全局装会导致不同项目版本互相打架。执行：

npm install webpack webpack-cli --save-dev 

注意那个--save-dev，意思是这两个包只在开发时需要，打包上线时用不到。webpack-cli是命令行工具，没有它你没法在终端里敲webpack命令。装完后你会发现node_modules文件夹出现了，体积还不小，别慌，这是正常的。

验证一下装没装成。在终端输入npx webpack --version，能输出版本号就说明成功了。npx是npm自带的工具，它会自动在当前项目的node_modules里找webpack，而不是去全局找。

到这一步，安装本身已经完成。但光装完不能直接用，得配一个入口文件。在项目根目录建一个src文件夹，里面放个index.js，随便写点代码，比如console.log('hello webpack')。然后在package.json里加一段脚本：

"scripts": {  "build": "webpack" } 

这样以后执行npm run build就能打包了。webpack默认会找src/index.js作为入口，输出到dist文件夹。如果你不想用默认配置，才需要建webpack.config.js文件去改入口和出口路径。

我遇到过最典型的坑是版本不匹配。webpack 5和webpack-cli 4搭配没问题，但如果你从网上复制了一段旧教程的代码，装的是webpack 4，那命令可能就报错了。所以装的时候最好指定版本，比如npm install webpack@5 webpack-cli@4 --save-dev，或者干脆不指定，让npm装最新的。

另一个容易踩的坑是网络慢。npm默认源在国外，国内用户经常超时。解决办法是换淘宝镜像：npm config set registry https://registry.npmmirror.com。换完源再装，速度快得飞起。

装完webpack，你还需要装一些loader和plugin才能处理CSS、图片这类资源。比如处理CSS要装style-loader和css-loader，处理图片要装file-loader或url-loader。这些都属于额外功能，按需安装就行，别一次性全装上，浪费空间不说，还可能互相冲突。

最后说个个人建议：别用全局安装的webpack。全局装虽然方便，但一旦你同时维护多个项目，不同项目依赖不同版本的webpack，全局那个就会捣乱。局部安装每次多敲几个字符，但省心得多。

整个流程走下来，顺利的话十分钟搞定。不顺利的话，八成是卡在版本上。记住一个原则：报错信息里提到什么，就去查什么，别瞎猜。webpack的报错提示已经写得很人性化了，照着改就行。