本篇不包含所有坑,暂时只记录自己踩到的部分坑
一.安装
安装webpack4最新版本
npm install --save-dev webpack@4
安装新增依赖 webpack-cli
这个在webpack3中,webpack本身和它的CLI是在同一个包中,webpack4中将两个分开管理。
npm install --save-dev webpack-cli
二.运行
执行本地打包以及运行操作
npm run build:dll
npm run start
记得添加mode
用来告知 webpack 使用相应环境的内置优化
module.exports = {
mode: 'production' //或者 'development'
};
其中遇到的报错:
1.Error:webpack.optimize.UglifyJsPlugin has been removed,pleaseuseconfig.optimization.minimizeinstead.
UglifyJsPlugin是用来对js文件进行压缩
webpack4中UglifyJsPlugin
被废除,需要安装新的插件uglifyjs-webpack-plugin
进行替换,见官方文档
安装uglifyjs-webpack-plugin
npm install uglifyjs-webpack-plugin --save-dev
更改 webpack.dll.config.js || webpack.prod.config.js
去除
- new webpack.optimize.UglifyJsPlugin({
- compress: {
- warnings: false
- },
- mangle: {
- safari10: true,
- },
- output: {
- comments: false,
- ascii_only: true,
- },
- sourceMap: false,
- comments: false
- }),
添加
const UglifyJsPlugin = require('uglifyjs-webpack-plugin');
...
optimization: { //与entry同级
minimizer: [
new UglifyJsPlugin({
uglifyOptions: {
compress: false,
mangle: true,
output: {
comments: false,
},
},
sourceMap: false,
})
]
},
注意:uglifyjs-webpack-plugin
更多的配置请参考详细配置
2.Error: webpack.optimize.CommonsChunkPlugin has been removed, please use config.optimization.splitChunks instead.
CommonsChunkPlugin 主要是用来提取第三方库和公共模块
CommonsChunkPlugin 已被移除,用splitChunks替代,见官方文档
更改webpack.base.config.js
去除
// new webpack.optimize.CommonsChunkPlugin({
// children: true,
// async: true,
// minChunks: 2,
// }),
添加
optimization: {
splitChunks: {
chunks: 'async',
minChunks: 2,
},
},
注意:splitChunks
更多的配置请参考详细配置
3.compilation.mainTemplate.applyPluginsWaterfall is not a function
更新html-webpack-plugin到最新版本
npm install html-webpack-plugin@latest --save-dev
4.Chunk.entrypoints: Use Chunks.groupsIterable and filter by instanceof Entrypoint instead
这个最后解决方式是用mini-css-extract-plugin
替代。
我记录下自己更新这个的过程,以下前半部分可以直接跳过。
- 更新extract-webpack-plugin到最新版本
npm install --save-dev [email protected]
继续报错
Path variable [contenthash] not implemented in this context: static/css/style.[contenthash].css
在之前版本中我们使用extract-text-webpack-plugin来提取CSS文件,不过在webpack 4.x中则应该使用mini-css-extract-plugin来提取CSS到单独文件中
更改如下
这是基于webpack 3.0
const utils = require('./utils')
const ExtractTextPlugin = require('extract-text-webpack-plugin')
module.exports = {
//...
new ExtractTextPlugin({
filename: utils.assetsPath('css/[name].[contenthash:7].css')
})
}
基于webpack 4.0
const utils = require('./utils')
const MiniCssExtractPlugin = require('mini-css-extract-plugin')
module.exports = {
//...
new MiniCssExtractPlugin({
filename: utils.assetsPath('css/[name].[contenthash:7].css')
})
}
css 以及 mini-css-extract-plugin 的 rule配置
module: {
rules: [
{
test: /\.(css|less)$/,
use: [
{
loader: MiniCssExtractPlugin.loader,
},
{
loader: 'css-loader',
options: {
modules: true,
importLoaders: 1,
localIdentName: '[local]'
}
},
{
loader: 'postcss-loader',
options: {
ident: 'postcss',
plugins: () => [
require('postcss-flexbugs-fixes'),
autoprefixer({
browsers: [
'>1%',
'last 4 versions',
'Firefox ESR',
'not ie < 9', // React doesn't support IE8 anyway
],
flexbox: 'no-2009',
}),
],
}
},
{
loader: 'less-loader',
options: {
modifyVars: theme
}
}
]
},
],
},
5.TypeError: webpack.optimize.DedupePlugin is not a constructor
DedupePlugin
是用来查找相等或近似的模块,避免在最终生成的文件中出现重复的模块
已经被废除,删除即可,见官网
6.FATAL ERROR: Ineffective mark-compacts near heap limit Allocation failed - JavaScript heap out of...
这个是内存溢出了,需要在启动命令中加一个空间 --max_old_space_size=4096
"scripts": {
"start": "better-npm-run start",
},
"betterScripts": {
"start": {
"command": "node --max_old_space_size=4096 build/server.js",
"env": {
"NODE_ENV": "development",
"DEPLOY_ENV": "",
"PUBLIC_URL": "",
"PORT": "8082"
}
},
}
7.最后还有一个大坑
offline-plugin
插件,配置service worker。这个插件的报错同以上UglifyJsPlugin
的报错。
只需要更新到最新版本即可。
以下记录踩坑过程。
Error:webpack.optimize.UglifyJsPlugin has been removed,pleaseuseconfig.optimization.minimizeinstead.
因此导致我,删了好几次UglifyJsPlugin
以及uglifyjs-webpack-plugin
相关的所有代码,然后依然报错。
又以为是缓存问题,我重启了vscode,重启了终端,电脑也尝试重启一遍,依然报错。
最后逐行注释代码,运行打包操作,发现是offline-plugin
插件的问题。
问题所在:offline-plugin
5.0以前的版本会带有webpack.optimize.UglifyJsPlugin
操作,最新的应该做了些处理。
详情参考
最后处理方式,更新offline-plugin
到最新的版本
npm install offline-plugin --save-dev
三、新增TypeScript的打包
安装
npm install --save-dev typescript ts-loader
添加tsconfig.json
文件
可以利用ts初始化命令自动添加
tsc --init
也可以手动新增文件。
其中配置详情如下,具体查阅tsconfig.json配置详情
{
"compilerOptions": {
"outDir": "./dist/",
"noImplicitAny": true,
"module": "commonjs",
"target": "es5",
"jsx": "react",
"allowJs": true,
"moduleResolution": "node",
"esModuleInterop": true,
"experimentalDecorators": true,
"noUnusedParameters": true,
"noUnusedLocals": true,
},
"module": "ESNext",
"exclude": ["node_modules"]
}
配置 webpack 处理 TypeScript, 主要更改点:
- 添加rule
- 添加需要处理的文件后缀,'.ts'、'.tsx'等
rules: [
{
test: /\.tsx?$/,
use: 'ts-loader',
exclude: /node_modules/
}
]
resolve: {
extensions: [ '.tsx', '.ts', '.js' ]
},
测试文件TestTsLoader.tsx
用来检测是否配置成功,导入相应页面即可测试。实测ok
import * as React from "react"
interface TsProps {
name: string
company: string
}
export default class TestTsLoader extends React.Component {
render() {
return (
Hello, I am {this.props.name}, I in {this.props.company} now!
)
}
}
参考资料
1. https://blog.csdn.net/harsima...
2. https://www.typescriptlang.or...
3. https://webpack.docschina.org...
四.再推荐一个npm script命令优化插件 better-npm-run
参考:
1. https://www.jianshu.com/p/710...
2. https://www.npmjs.com/package...