[ webpack4 ] 配置属于自己的打包系统教程(一)—— 基础配置篇
GitHub 完整配置文件地址: https://github.com/yhtx1997/webpack4-Instance
由于篇幅过长分三次发布,建议按顺序看
[ webpack4 ] 配置属于自己的打包系统教程(一)—— 基础配置篇
[ webpack4 ] 配置属于自己的打包系统教程(二)—— 资源配置篇
[ webpack4 ] 配置属于自己的打包系统教程(最终篇)—— 环境配置篇
基础配置篇
主要内容
- 安装 webpack4
- 目录初始化
- 配置初始化
- 入口及多入口配置
- 出口配置
安装 webpack4
安装 webpack 前请确保已安装 nodejs 和 npm
新建 npm 项目
npm init -y
这里的init表示初始化一个 npm 项目, -y 表示全部选 yes,不加的话会提示输入一些项目信息,比如项目名,版本号,作者...
安装 webpack4
npm install webpack webpack-cli webpack-dev-server -D
这其实是一条合并的命令,拆开就是
npm install webpack -D npm install webpack-cli -D npm install webpack-dev-server -D
- install 是安装的意思; -D 表示安装到本地开发环境,不使用全局安装是因为每个项目可能用的 webpack 版本不一样导致冲突
- 第一条安装的是 webpack 的核心文件,就好比是安装包
- 第二条是让 webpack 支持类似 npm run dev 这种命令行命令
- 第三条安装的是可以使 webpack 支持实时编译的拓展包
初始化 npm 配置及文件
现阶段的目标是让它能运行起来
现在目录下应该有一个文件夹,两个 .josn 文件
- node_modules 用来存放所有安装的 npm 包
- package.json 在这里配置 npm run 的脚本,以及包含项目信息,安装了哪些包
- package-lock 详细的包的版本来源,确保项目所有开发人员用的都是一个版本
调整 package.json
官方推荐移除文件中的入口配置,这样可以防止意外发布你的代码。
"main": "index.js"
并加上私有属性配置
"private": true
运行webpack 可以用在命令行输入 npx webpack
但是这样的运行方式在配置了开发环境和生产环境时,再运行需要写很多参数
所以添加一个 npm 脚本,之后运行 输入 npm run test 即可,有参数后在后边追加即可
"test": "webpack"
最后看起来像这样
新建入口文件及生成出口文件
在 webpack 4 中,可以无须任何配置使用,做完上边的操作后可以在命令行输入 npm run test 运行 webpack(这里的 test 是在上边 scripts 里自己定义的),但是会显示这样的结果。
这是因为入口文件不存在,webpack 默认是将当前目录下的 ./src/index.js 当做要打包的文件(入口),新建一下 src 目录和 index.js 文件,就可以正常了。
这时会生成一个 dist 目录以及目录里有一个 main.js,这是默认的打包好的文件及目录(出口),这样一个 webpack 算是初始化完成了。
注:
- 最终发布时如果只需要一个 js,那么开发时 index.js 里推荐是只用来引入其他 js 文件(import)。
- 在截止 2018年12月31日 据我所知道的目前 import 和 export 还只是概念上的标准, js 还不能原生支持 import 和 export ,大家能使用是因为配置了 babel ,通过 babel 进行编译,使其变成 node.js 的代码,使其可以将这条命令视为加载模块。 nodejs 采用 CommonJS规范,关于 ES6 这方面的可以看 ES6 Module 的语法。
webpack4 入口出口配置
在上面也说了 webpack4 现在可以无需使用任何配置文件就可以使用,但是有些东西还是弄成自己喜欢的比较好
新建配置文件
在当前目录下新建一个 webpack.config.js 文件,并写入代码
const path = require('path');//[1] module.exports = { //[2] };
- [1] 是引入 node 的 path 模块,这样就可以处理文件与目录的路径,处理路径是因为 windows 系列和 Linux 系列在路径的表示上不太一样。
- [2] 是对外暴露大括号 {} 中的内容,用来写我们自定义的配置
- 注:关于配置文件名,wepack4 默认是会引入 ./webpack.config.js ,如果想自己改名字的话可以在命令行输入一下代码,其中 webpack --config 是必须的, my.config.js 是自己自定义的配置文件的路径
webpack --config my.config.js
入口配置
为了能证明入口确实改了有效果,我将 ./src/index.js 的文件名改为 2048.js,并放到./src/js/2048.js ;
并修改代码
const path = require('path'); module.exports = { entry: "./src/2048.js"//add };
在不加上面代码时会报之前的找不到入口的错误,加了以后会显示正常输出了,并且 ./dis 下会多一个 2048.js 的文件,
多入口配置
entry 不光能赋值绝对路径的字符串,还能赋值多个路径的数组或对象
entry: './src/2048.js'//单入口 字符串传参 entry: ['./src/js/2048.js','./src/js/1024.js','./src/js/512.js']//多入口 数组传参 entry: {//多入口 对象传参 2048: './src/js/2048.js', 1024: './src/js/1024.js', 512: './src/js/512.js' }
出口配置
出口跟入口不太一样,入口可以有很多,但是只有一个输出配置。
output: { filename: '2048.js', path: 'C:/Users/GengShaojing/Desktop/2048/dist' }
- filename 打包后文件的文件名。
- path 打包后文件的的绝对路径。
多入口多输出文件
output: { filename: '[name].js',//[1] path: path.resolve(__dirname, 'dist')//[2] }
- [1] [name] 表示使用 entry 传递过来的文件的文件名或者对象的 key 值
- [2] __dirname 指向当前文件(webpack 配置文件)的绝对路径, path.resolve 是解析路径并在路径后加上 dist
每次修改后生成不一样的文件名
output: { filename: "[name].[chunkhash].js", path: path.resolve(__dirname, 'dist') }
filename 支持以下几个属性,且可以共存
- [name] 模块名称 就是之前说的文件名或者对象的 key 值
- [id] 模块标识符 应该是入口传入顺序的下标值从 0 开始
- [hash] 模块标识符的哈希值 这个我理解的不太清楚,只知道他可以生成字符串
- [chunkhash] 内容的哈希值 根据内容生成字符串
- [contenthash] 提取的内容生成的哈希值 根据提取的内容生成字符串
- 注:官方推荐 [name] 加上 [chunkhash] 的模式
- 注:哈希值就是用算法提取的标识信息,相当于人和录入指纹,哈希值就是人录入指纹的机器,最后的字符串就是指纹