Learning Webpack 一、安装 1. 本地安装 # webpack 4+ 版本 npm install --save-dev webpack-cli npm install --save-dev webpack # 安装指定版本 npm install --save-dev webpack@<version> 2. 全局安装(官方不推荐) npm install --global webpack 3. 最新体验版安装 npm install webpack@beta npm install webpack/webpack#<tagname/branchname> 3. 运行 webpack 二、入门 1. 项目初始化 mkdir webpack-demo && cd webpack-demo npm init -y npm install webpack webpack-cli --save-dev 2. 初始化源码目录 mkdir src cd src new-item index.js cd .. mkdir dist cd dist new-item index.html 3. 创建配置文件 webpack.config.js const path = require('path'); module.exports = { entry: './src/index.js', // 入口文件地址 output: { filename: 'bundle.js', // 出口文件名 path: path.resolve(__dirname, 'dist') // 告诉 webpack 在哪里生成文件 } }; 4. 添加npm脚本 { "name": "webpack-demo", "private": true, "version": "1.0.0", "description": "", "main": "index.js", "scripts": { "test": "echo \"Error: no test specified\" && exit 1", + "build": "webpack" }, "keywords": [], "author": "", "license": "ISC", "devDependencies": { "webpack": "^4.0.1", "webpack-cli": "^2.0.9", "lodash": "^4.17.5" } } 5. 开始使用 webpack 打包:npm run build
具体事例请参考 example 目录下的 chapterOne
三、静态资源管理 0. 创建静态资源目录 asset 1. css(1) 安装对应的 loader: npm install --save-dev style-loader css-loader
(2) 配置 loader:
module: { rules: [{ test: /\.css$/, use: [ 'style-loader', 'css-loader' ] }] }(3) 静态资源目录添加 style.css 文件,在入口文件中引用,在打包时, webpack 会把对应的 css 代码插入到 index.html 的 head 中。
2. 图片(1) 安装对应的 loader: npm install --save-dev file-loader
(2) 配置 loader:
{ test: /\.(png|svg|jpg|gif)$/, use: [ 'file-loader' ] }(3) 静态资源目录添加一张图片,在入口文件中引用,打包时, webpack 会生成目标文件夹中的最终 url,并将入口文件中的路径替换为最终路径。
3. 字体(1) 配置 loader:
{ test: /\.(woff|woff2|eot|ttf|otf)$/, use: [ 'file-loader' ] }(2) 静态资源目录添加字体,在入口文件中引用,打包时, webpack 会生成目标文件夹中的最终 url,并将入口文件中的路径替换为最终路径。
4. 数据(json、xml、csv)(1) 安装对应的 loader: npm install --save-dev csv-loader xml-loader
(2) 配置 loader:
{ test: /\.(csv|tsv)$/, use: [ 'csv-loader' ] }, { test: /\.xml$/, use: [ 'xml-loader' ] }(3) 静态资源目录添加对应的数据文件,在入口文件中引用数据文件, 打包之后,对应的数据文件会被处理为 json 格式的数据
具体事例请参考 example 目录下的 chapterTwo
四、输出管理 0. 入口分离(1) 源码目录中新建 print.js 文件,并在 index.js 中引用对应模块,index.js 中引用对应的包
(2) webpack 配置修改:
const path = require('path'); module.exports = { mode: 'development', entry: { app: './src/index.js', print: './src/print.js' }, output: { filename: '[name].bundle.js', path: path.resolve(__dirname, 'dist') } }; 1. 解决引用重复的问题,每次打包生成新的 html 文件(1) 设定 HtmlWebpackPlugin
安装 html-webpack-plugin: npm install --save-dev html-webpack-plugin
(2) 配置 HtmlWebpackPlugin
const HtmlWebpackPlugin = require('html-webpack-plugin'); plugins: [ new HtmlWebpackPlugin({ title: 'Output Management' }) ],(3) 在打包时, HtmlWebpackPlugin 会生成新的 index.html 文件,替换旧的 index.html 文件
2. 删除遗留的多余文件,在每次构建前清理 /dist 文件夹(1) 安装插件: npm install clean-webpack-plugin --save-dev
(2) 配置插件:
const { CleanWebpackPlugin } = require('clean-webpack-plugin'); new CleanWebpackPlugin(),具体事例请参考 example 目录下的 chapterThree
五、开发环境配置 1. 将编译后的代码映射回原始源代码(1) 配置文件中添加 source map 配置: devtool: 'inline-source-map'
(2) 入口文件有错误,控制台返回的错误路径是对应的源路径
2. 自动编译代码(1) 观察模式:
添加 script 脚本:"watch": "webpack --watch"
npm run watch,每次更新入口文件,代码将自动编译,但是每次编译后,需要手动刷新浏览器,页面才会更新
(2) webpack-dev-server(一个简单的web服务器,可以实时重新加载页面)(官方推荐使用)
安装: npm install --save-dev webpack-dev-server
修改配置文件:告知 webpack-dev-server 在哪里查找文件
devServer: { contentBase: './dist' }添加 script 脚本
"start": "webpack-dev-server --open",修改源文件,web 服务器就会自动重新加载编译后的代码
(3) webpack-dev-middleware(模块热替换),把 webpack 处理后的文件传递给一个服务器(server)
安装 express 和 webpack-dev-middleware: npm install --save-dev express webpack-dev-middleware
配置文件中 output 添加 publicPat 选项: publicPath: 'http://www.likecs.com/'