[ webpack4 ] 配置属于自己的打包系统教程(一)—— 基础配置篇

1,933 阅读5分钟

GitHub 完整配置文件地址: https://github.com/yhtx1997/webpack4-Instance

由于篇幅过长分三次发布,建议按顺序看

基础配置篇

主要内容

  • 安装 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"

最后看起来像这样

初始package

新建入口文件及生成出口文件

在 webpack 4 中,可以无须任何配置使用,做完上边的操作后可以在命令行输入 npm run test 运行 webpack(这里的 test 是在上边 scripts 里自己定义的),但是会显示这样的结果。

图片描述

这是因为入口文件不存在,webpack 默认是将当前目录下的 ./src/index.js 当做要打包的文件(入口),新建一下 src 目录和 index.js 文件,就可以正常了。

clipboard.png

这时会生成一个 dist 目录以及目录里有一个 main.js,这是默认的打包好的文件及目录(出口),这样一个 webpack 算是初始化完成了。

clipboard.png
clipboard.png

注:

  • 最终发布时如果只需要一个 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 的文件,

clipboard.png

多入口配置

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] 的模式

  • 注:哈希值就是用算法提取的标识信息,相当于人和录入指纹,哈希值就是人录入指纹的机器,最后的字符串就是指纹