webpack4学习笔记(一)
前言
这是我花了几个星期学习webpack4的学习笔记。内容不够细,因为一些相对比较简单的,就随意带过了。希望文章能给大家带来帮助。如有错误,希望及时指出。例子都在learn-webpack仓库上。如果你从中有所收获的话,希望你能给我的github
点个star
。
小知识
npm info webpack
查看webpack的历史版本信息等npm init -y
跳过那些选项,默认
全局安装的webpack
: webpack index.js
打包
项目中安装的webpack
: npx webpack index.js
打包script
中脚本打包 : npm run build
命令行中打包:npx webpack index.js -o bundle.js
入口是index.js
, 出口是bundle.js
webpack4
设置mode:production
会压缩代码 development
就不压缩代码
打包 output
里面[name].js loader
中的name
变量 其实就是entry:{main: index.js} 中的key => main
source-map
devtool: source-map
source-map
: dist
文件夹里会多生成个map
后缀文件,这样页面报错的时候,点击报错后面的地址,会跳转到代码写的地方。而不会跳转到打包后的代码里。inline-source-map
: 不会新生成.map文件,会插入到打包的文件底部cheap-inline-source-map
: 因为inline-source-map
报错会告诉你第几行第几个字符。前面加上cheap
的话 只会告诉你第几行cheap-module-inline-source-map
: 本来map只会映射打包出来的index.js跟业务代码中的关系。第三方引入库报错映射不到。中间加了module这个参数就可以了。比如loader
也会有source-map
开发的时候建议使用:cheap-module-eval-source-map
,eval
表示不会独立生成map文件,而是打包进代码里。
一般development
环境用 cheap-module-eval-source-map
production
环境用cheap-module-source-map
loader
// style.css body { color: red; }
当你想给项目添加样式的时候,import ./style.css
导入css
,并执行打包命令的时候。页面并报错
ERROR in ./style.css 1:5 Module parse failed: Unexpected token (1:5) You may need an appropriate loader to handle this file type.
这个时候就需要使用loader
来编译了。
安装:npm i style-loader css-loader -D
为什么还需要安装style-loader
呢?因为style-loader
会将你的样式通过style
标签插入到页面中
配置webpack.config.js
// webpack.config.js const HtmlWebpackPlugin = require('html-webpack-plugin') module.exports = { mode: "development", entry: './index.js', output: { filename: 'bundle.js' }, module: { rules: [ { test: /\.css$/, use: ['style-loader', 'css-loader'] } ] }, plugins: [ new HtmlWebpackPlugin() ] }
上面使用了HtmlWebpackPlugin
是因为我用它来自动生成index.html
方便页面访问
// package.json "scripts": { "build": "webpack --config webpack.config.js" },
执行npm run build
进行打包,访问dist
目录下的index.html
,可以看到页面显示成功。loader
执行顺序是从下到上,右到左。
webpack-dev-server
webpack-dev-server
webpack-dev-server
会对你的代码进行打包,将打包的内容放到内存里面,并不会自动给你打包放进dist里。webpack —watch
页面会刷新下,内容会自动更新webpack-dev-server
会自动更新当前页面webpack-dev-server
, 现在的webpack-dev-server
比以前好多了vue-cli3
和react
都是用这个了
devServer: { contentBase: './dist', // 有这个就够了, open: true, // 自动打开浏览器 port: 8080, // 端口不必填 proxy: {'/api': http://localhost:3000} }
启动服务来热更新
npm install express webpack-dev-middleware -D
在output
中添加publicPath
const express = require('express') const webpack = require('webpack') const webpackDevMiddleWare = require('webpack-dev-middleware') const config = require('./webpack.config.js') const complier = webpack(config) // 帮我们做编译的东西,webpack传入config之后会申请一个编译器 app.use(webpackDevMiddleware(complier, { publicPath: config.output.publicPath, // 意思是只要文件改变了,就重新运行 })) const app = express() app.listen(3000, () => { console.log('server is running 3000') })
现在这样子写太麻烦了(vue-cli2也是如此)。因为以前版本webpack-dev-server
还不够强大,现在不一样了。非常的强大了。
Hot Module Replacement
热替换,就是不会刷新整个页面。当不使用热更新的时候,操作一些功能,新增了三个元素,修改样式页面自动刷新后,刚才新增的元素会消失。如果开启了热替换,那么原先的dom会还在。
const webpack = require('webpack') // .... devServer: { contentBase: './dist', open: true, hot: true, hotOnly: true // 以防hot失效后,页面被刷新,使用这个,hot失效也不刷新页面 }, // ... plugins: [ new webpack.HotModuleReplacementPlugin() ]
import number from './number.js' if (module.hot) { // 如果热更新存在 // 监听的文件改变,会触发后面的回调方法 module.hot.accept('./number', () => { // dosomething }) }
为什么修改了css文件不需要写module.hot。而写js需要写呢,因为css-loader已经自动帮你处理了。
babel
基本用法
将高版本的js代码转换成低版本的js代码。比如ie浏览器不兼容es6,需要使用babel把es6代码把js转换成低版本的js代码。
安装:npm install --save-dev babel-loader @babel/core
module: { rules: [ { test: /\.js$/, exclude: /node_modules/, loader: "babel-loader" } ] }
babel-loader
并不会帮助你把es6语法转换成低级的语法。它只是帮助打通webpack跟babel之间的联系。
转换成es5的语法:
安装:npm install @babel/preset-env --save-dev
@babel/preset-env
包含了es6转换成es5的所有规则。
module: { rules: [ { test: /\.js$/, exclude: /node_modules/, loader: "babel-loader", options: { "presets": ["@babel/preset-env"] } } ] }
如果还需要降到更低版本就得使用babel-polyfill
安装:npm install --save @babel/polyfill
页面顶部引入import "@babel/polyfill";
就可以将高级版本语法转换成低级语法。但是直接import
会让打包后的文件非常大。
这个时候就需要再配置webpack.config.js
useBuiltIns
{ test: /\.js$/, exclude: /node_modules/, loader: "babel-loader", options: { // "presets": ["@babel/preset-env"] // 当你做babel-polyfill往浏览器填充的时候,根据业务代码用到什么加什么,并不会全部写入, // 数组中,后面的对象是对数组前面的babel做配置 "presets": [["@babel/preset-env", { useBuiltIns: 'usage' }]] } }
如果开发一个第三方库,类库。使用babel-polyfill
会注入到全局,污染到全局环境。
安装:npm install --save-dev @babel/plugin-transform-runtime
安装:npm install --save @babel/runtime
{ test: /\.js$/, exclude: /node_modules/, loader: "babel-loader", options: { "plugins": ["@babel/plugin-transform-runtime"] } }
当你要添加配置时
{ test: /\.js$/, exclude: /node_modules/, loader: "babel-loader", options: { "plugins": [["@babel/plugin-transform-runtime", { "absoluteRuntime": false, "corejs": false, "helpers": true, "regenerator": true, "useESModules": false }]] } }
如果你要将corejs赋值为2
安装:npm install --save @babel/runtime-corejs2
{ test: /\.js$/, exclude: /node_modules/, loader: "babel-loader", options: { "plugins": [["@babel/plugin-transform-runtime", { "absoluteRuntime": false, "corejs": 2, "helpers": true, "regenerator": true, "useESModules": false }]] } }
@babel/plugin-transform-runtime
不会污染到全局环境。
当babel配置非常多的时候,可以将他们放到.babelrc
文件里
在根目录下创建.babelrc
文件
将options
里的代码放到这个文件中,如下:
{ "plugins": [["@babel/plugin-transform-runtime", { "absoluteRuntime": false, "corejs": 2, "helpers": true, "regenerator": true, "useESModules": false }]] }
react中应用babel
安装:npm install --save-dev @babel/preset-react
往刚刚的.babelrc
文件中添加配置
// presets对应一个数组,如果这个值需要做配置,那么这个值在包装进一个数组,放到第一项,第二项是个对象,用于描述该babel { "presets": [ ["@babel/preset-env", { "useBuiltIns": "usage" }], "@babel/preset-react" ] }
注意:转换是先下后上,就是使用preset-react转换react代码,再用preset-env将js代码转换为es5代码