Webpack 快乐学习之旅(一)

记录 webpack 安装和配置的过程,以及即将遇到的各种坑. 🙂

环境:win10, webpack@3.6.0

1. webpack 安装

1.1 安装过程

  1. 在安装 webpack 之前,需要先安装 Nodejs(这个过程会自动帮你安装好 npm)。路径的话默认是 C 盘,因为强迫症,我把它安装在了 D 盘。

  2. 安装好 Nodejs 后,在 cmd 命令行里可以通过 node -vnpm -v 分别查看版本信息,一般这里没啥问题。

  3. 之后一定不要忘记配置 Nodejs 的环境变量(具体步骤看1.2)
  4. 接着就是安装 webpack 了,因为练手的项目用的是 4.x 之前的版本,我这里用 npm install webpack@3.6.0 -g 进行全局安装。
  5. webpack -v 查看版本信息,没毛病

1.2 Nodejs 环境变量配置

之前急着搭建博客,所以 Nodejs 安装好后就没管了,今天 webpack -v 命令死活用不了(提示“webpack 不是内部命令”),才发现是因为当时忘记配置环境变量了。

分两步:

(1) 修改全局安装位置

默认情况下,Nodejs 会给系统环境创建两个环境变量:

  • 用户变量 PATH: C:\Users\Admin\AppData\Roaming\npm
  • 系统变量 PATH:D:\Nodejs

第一个变量指定了全局安装的东西默认存放的位置,因为我实在不想放在 C 盘,于是得改一下这个默认配置,具体做法:

  • 首先在 Nodejs 文件夹中新建 node_global 和 node_cache 文件夹,分别用于存放全局安装包和临时缓存位置;

  • 接着 cmd 里设置全局安装路径和全局缓存路径(也就是刚才那两个):

npm config set prefix "D:\Nodejs\node_global"
npm config set cache "D:\Nodejs\node_cache"

之后可以用 npm root -g 查看一下

这之后再次安装 webpack,不出意外它就会出现在 Nodejs/node_global 文件夹下了。不过我们还是查看不了版本,因为环境变量还没修改。

(2)修改环境变量

我的电脑——右键属性——高级系统设置——高级———环境变量:

  • 用户变量:修改 PATHD:\Node.js\node_global
  • 系统变量:新增 NODE_PATH ,设置值为 D:\Node.js\node_global

PS:第二个貌似也可以设置为 D:\Node.js\node_global\node_modules

之后重启 cmd (一定要重启,不然是不生效的),再次 webpack -v ,这次就可以正常使用了。

2. 基本结构搭建

1.练手的话先新建一个项目,然后 cd 进去:

mkdir webpack-learning
cd webpack-learning

以后就是在这个文件夹里搞事情了。

2.创建 index.html 文件和 src 文件夹,后者存放打包前的文件

3.通过 npm init 生成 package.json 文件,这个文件用来描述项目信息以及依赖配置等。这里基本一路回车就好。

4.通过 npm install webpack@3.6.0 --save -dev 本地安装 webpack。本地安装可以让每个项目拥有独立的包,不受全局包的影响,方便项目的移动、复制、打包等 。

5.手动创建 webpack.config.js 文件,这个文件用来配置 webpack 的运行方式

那么,现在项目结构看起来大概如下:

3. 配置 webpack.config.js 和 package.json

先简单配置一下 webpack.config.js :

const path = require('path');
module.exports = {
    entry:'./src/main.js',
    output:{
        path:path.resolve(__dirname,'dist'),
        filename:'bundle.js'
    }
}

这里定义了入口和出口。 入口(entry) 指示 webpack 应该使用哪个模块文件来作为构建内部依赖的开始,进入入口起点后,webpack 会找出有哪些模块和库是入口 js 依赖的;

出口(output) 是告诉 webpack 在什么地方输出它所创建的 bundles,以及如何命名这些打包文件。

我们新建几个文件来简单测试下。首先是 module.js :

var num = 1;
function add(){
    num++;
}
export {num,add}

main.js 作为入口文件:

import {num,add}
console.log(num)
add()
console.log(num)

main.js 进行打包:

$ webpack ./src/main.js ./dist/bundle.js

会发现项目文件夹下多出来一个 dist 文件夹,里面有一个打包生成的 bundle.js 文件:

之后在 index.html 中直接引用该文件:


浏览器跑一下,没毛病。

不过,之前的打包命令太麻烦了,所以我们配置一下 package.json

"scripts": {
    "test": "echo \"Error: no test specified\" && exit 1",
    "build": "webpack"
  },

之后可以直接通过 npm run build 执行打包。