【翻译】Webpack 4 从0配置到生产模式
webpack 4 发布了!
webpack 4 作为一个零配置的模块打包器
webpack 是强大的并且有许多独一无二的特点但是有一个痛点就是配置文件。
在中型到大型项目中为webpack提供一个配置并不是什么大问题。你不可能没有任何配置。然而,对于小一些的项目这就是烦恼了,尤其是当你想启动一些玩具项目。
这就是为什么Parcel获得如此之多关注的原因
现在:webpack 4 默认不需要任何配置。
让我们尝试一下。
webpack 4: 0 配置启动
创建一个新的文件夹并进入:
mkdir webpack-4-quickstart && cd $_
初始化package.json通过运行
npm init -y
添加webpack 4:
npm i webpack --save-dev
我们还需要webpack-cli,它作为一个包独立存在:
npm i webpack-cli --save-dev
现在打开package.json文件添加build脚本
"scripts": {
"build": "webpack"
}
关闭并保存文件
试着去运行
npm run build
然后你会看到
ERROR in Entry module not found: Error: Can't resolve './src' in '~/webpack-4-quickstart'
webpack 4正在寻找./src中的入口点!如果你不知道这意味着什么去看看我以前的文章从Gulp切换到webpack
简而言之:入口点是webpack开始构建Javascript包寻找的文件。
在之前的webpack版本中,入口点必须在名为webpack.config.js的配置文件中定义。
但是从webpack 4开始,不需要定义入口点:它会将./src/index.js作为默认值!
测试这个新特性非常容易。创建./src/index.js
:
console.log(`I'm a silly entry point`);
然后重新运行build命令
npm run build
你会得到这个包 ~/webpack-4-quickstart/dist/main.js
。
什么?等一下?刚才那里不需要定义出口文件吗?
在webpack 4 中不需要定义入口也不需要定义出口。
webpack的主要优势是代码分割。但相信我,使用零配置工具可以加快速度。
所以这是第一条新闻:webpack 4不需要配置文件。
它会查找./src/index.js作为默认入口点。而且,它会在./dist/main.js中输出这个包。
在下一节中,我们将看到webpack 4的另一个很好的功能:生产和开发模式。
webpack 4:生产和开发模式
拥有2个配置文件是webpack中的常见模式。
一个典型的项目可能有:
- 一个用于开发的配置文件,用于定义webpack dev服务器和其他东西
- 用于生产的配置文件,用于定义UglifyJSPlugin,sourcemaps等
虽然在大的项目可能仍然需要2个文件,但是在webpack 4中,您可以无需任何配置。
怎么会这样呢?
webpack 4 采用了生产和开发模式。
实际上,如果你注意到npm run build
的输出,你会看到一个很好的警告:
The 'mode' option has not been set. Set 'mode' option to 'development' or 'production' to enable defaults for this environment.
'mode'选型还没有被设置。设置'mode'选项为'development'或者'production'以启用环境的默认值。
什么意思?让我们看一下
打开package.json文件在script部分写入
"scripts": {
"dev": "webpack --mode development",
"build": "webpack --mode production"
}
现在试着运行
npm run dev
然后打开./dist/main.js
看一下。你发现什么?是的,我知道,一个无聊的包文件。。。没有被压缩。。。
接着运行
npm run build
再看一下./dist/main.js
。现在你看到什么?一个被压缩的文件。
是的!
生产模式可以实现各种优化。包括minification,scope hoisting,tree-shaking等等。
另一方面,开发模式针对速度进行了优化,只不过是提供未缩小的捆绑包。
下面是第二条新闻:webpack 4引入了生产和开发模式。
在webpack 4中,你可以不用一行配置!只需定义--mode
标识,即可轻松获得一切!
webpack 4: 覆盖默认的输入/输出
我喜欢webpack 4 零配置,但是如何覆盖默认入口点?和默认输出?
在package.json
中配置它们!
这里是一个例子:
"scripts": {
"dev": "webpack --mode development ./foo/src/js/index.js --output ./foo/main.js",
"build": "webpack --mode production ./foo/src/js/index.js --output ./foo/main.js"
}
webpack 4: 使用Babel转译JavaScript ES6
现代Javascript主要是用ES6编写的。
但并不是每个浏览器都知道如何处理ES6。我们需要某种转译。
这个转换步骤被称为transpiling。 Transpiling是采用ES6并使旧版浏览器可以理解的行为。
Webpack不知道如何进行转换,但有loaders: 把它们想象成转换器。
babel loader是将ES6及更高版本转换为ES5的webpack加载器。
要开始使用加载器,我们需要安装一堆依赖项。尤其是:
- babel-core
- babel-loader
- babel-preset-env
使用下面命令:
npm i babel-core babel-loader babel-preset-env --save-dev
接下来,通过在项目文件夹中创建一个名为.babelrc
的新文件来配置Babel:
{
"presets": [
"env"
]
}
此时我们有两种配置babel-loader的选项:
- 使用webpack的配置文件
- 在你的npm脚本中使用
--module-bindin
是的,我知道你在想什么。 webpack 4将自己定位为零配置工具。为什么你会再次写一个配置文件?
webpack 4中零配置的概念适用于:
- 入口点。默认为./src/index.js
- 输出。默认为./dist/main.js
- 生产和开发模式(无需为生产和开发创建两个单独的配置文件)
这就够了。但是对于在webpack 4中使用装载器,你仍然需要创建一个配置文件。
我已经问过Sean了。webpack 4中的装载机制会和webpack 3一样吗?有没有计划为像babel-loader这样的普通装载机提供零配置?
他的回应是:
“对于未来(在v4之后,也许是4.x或5.0),我们已经开始探索预设或附加系统如何帮助定义这一点。 我们不想要的东西:尝试将一堆东西推入核心作为默认值我们所需要的:允许其他扩展。”
现在你必须依靠webpack.config.js。让我们来看看…
webpack 4:在配置文件中使用babel-loader
给webpack一个配置文件,以最经典的方式使用babel-loader。
创建一个名为webpack.config.js
的新文件并配置加载器:
module.exports = {
module: {
rules: [
{
test: /\.js$/,
exclude: /node_modules/,
use: {
loader: "babel-loader"
}
}
]
}
};
除非要定制它,否则不需要指定入口点。
接下来打开./src/index.js并编写一些ES6:
const arr = [1, 2, 3];
const iAmJavascriptES6 = () => console.log(...arr);
window.iAmJavascriptES6 = iAmJavascriptES6;
最后通过下面命令打包:
npm run build
现在看看./dist/main.js来查看编译过的代码。
webpack 4:使用没有配置文件的babel-loader
还有另一种使用webpack装载机的方法。
--module-bindflag
允许您从命令行指定加载器。谢谢Cezar指出这一点。
该标志不是webpack 4特有的。从第3版开始,它就在那里。
要在没有配置文件的情况下使用babel-loader,请在package.json中配置npm脚本,如下所示:
"scripts": {
"dev": "webpack --mode development --module-bind js=babel-loader",
"build": "webpack --mode production --module-bind js=babel-loader"
}
你准备好运行构建。
我不是这种方法的粉丝(我不喜欢臃肿的npm脚本),但它仍然很有趣。
webpack 4:配置React的webpack 4环境
一旦你安装并配置了babel,这很简单。
安装React:
npm i react react-dom --save
然后添加babel-preset-react
:
npm i babel-preset-react --save-dev
配置 . babelrc 中的preset:
{
"presets": ["env", "react"]
}
这就好了!
正如Conner Aiken所建议的,你可以配置babel-loader来读取.jsx文件。如果您为您的React组件使用jsx扩展,这很有用。
打开webpack.config.js
并像这样配置加载器:
module.exports = {
module: {
rules: [
{
test: /\.(js|jsx)$/,
exclude: /node_modules/,
use: {
loader: "babel-loader"
}
}
]
}
};
为了测试方便,你可以在./src/App.js
中创建一个假的的React组件:
import React from "react";
import ReactDOM from "react-dom";
const App = () => {
return (
<div>
<p>React here!</p>
</div>
);
};
export default App;
ReactDOM.render(<App />, document.getElementById("app"));
然后在./src/index.js
导入组件:
import App from "./App";
再次运行构建。
webpack 4: HTML webpack plugin
webpack需要两个额外的组件来处理HTML:html-webpack-plugin和html-loader。
添加依赖:
npm i html-webpack-plugin html-loader --save-dev
更新webpack配置文件:
const HtmlWebPackPlugin = require("html-webpack-plugin");
module.exports = {
module: {
rules: [
{
test: /\.js$/,
exclude: /node_modules/,
use: {
loader: "babel-loader"
}
},
{
test: /\.html$/,
use: [
{
loader: "html-loader",
options: { minimize: true }
}
]
}
]
},
plugins: [
new HtmlWebPackPlugin({
template: "./src/index.html",
filename: "./index.html"
})
]
};
创建HTML文件./src/index.html
:
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="utf-8">
<title>webpack 4 quickstart</title>
</head>
<body>
<div id="app">
</div>
</body>
</html>
运行构建命令:
npm run build
查看./dist
文件夹。就能看到输出的HTML文件。
不需要将HTML包含在HTML文件中:该包将被自动注入。
在浏览器中打开./dist/index.html:你应该看到React组件正在工作!
正如你所看到的,在处理HTML方面没有任何改变。
webpack 4仍然是一个针对Javascript的模块打包器。
但是有计划将HTML作为模块添加(HTML作为入口点)。
webpack 4:将CSS提取到一个文件中
webpack并不知道如何将CSS提取到文件中
在过去,这是extract-text-webpack-plugin的工作。
不幸的是,这个插件与webpack 4不兼容。
mini-css-extract-plugin成为了新的代替品。
安装插件和css-loader:
npm i mini-css-extract-plugin css-loader --save-dev
接下来创建一个css文件用来测试:
/* */
/* CREATE THIS FILE IN ./src/main.css */
/* */
body {
line-height: 2;
}
配置插件和loader:
const HtmlWebPackPlugin = require("html-webpack-plugin");
const MiniCssExtractPlugin = require("mini-css-extract-plugin");
module.exports = {
module: {
rules: [
{
test: /\.js$/,
exclude: /node_modules/,
use: {
loader: "babel-loader"
}
},
{
test: /\.html$/,
use: [
{
loader: "html-loader",
options: { minimize: true }
}
]
},
{
test: /\.css$/,
use: [MiniCssExtractPlugin.loader, "css-loader"]
}
]
},
plugins: [
new HtmlWebPackPlugin({
template: "./src/index.html",
filename: "./index.html"
}),
new MiniCssExtractPlugin({
filename: "[name].css",
chunkFilename: "[id].css"
})
]
};
最后在./src/index.js中导入:
//
// PATH OF THIS FILE: ./src/index.js
//
import style from "./main.css";
然后构建:
npm run build
并查看./dist文件夹。你应该看到由此产生的CSS!
回顾一下:extract-text-webpack-plugin不能与webpack 4一起使用。请改用mini-css-extract-plugin。
webpack 4 : webpack dev server
想当你的代码改变的时候自动运行 npm run dev
?很简单。
使用webpack配置开发服务器只需一分钟。
一旦配置好webpack dev server将在浏览器中启动你的应用程序。
每次更改文件时,它都会自动刷新浏览器的窗口。
安装webpack-dev-server:
npm i webpack-dev-server --save-dev
接下来打开package.json
并调整脚本,如下所示:
"scripts": {
"start": "webpack-dev-server --mode development --open",
"build": "webpack --mode production"
}
关闭并保存文件。
接下来运行
npm run start
你会看到webpack dev server在浏览器中启动你的应用程序。
webpack dev server非常适合开发。(这使得React Dev Tools能够在浏览器中正常工作)。
webpack 4: 资源
A Github repo for the tutorial => webpack-4-quickstart
I know there’s already an awesome webpack list but here’s mine: a list of awesome resources about webpack 4 => awesome-webpack-4
It would be remiss not to mention SurviveJS webpack 4 by Juho Vepsäläinen