【webpack】配置
使用不同语言配置js/ts/coffee
:
- 为了用
TypeScript
书写webpack
的配置文件,必须先安装相关依赖:
npm install --save-dev typescript ts-node @types/node @types/webpack
- 类似的,为了使用
CoffeeScript
来书写配置文件, 同样需要安装相关的依赖:
npm install --save-dev coffee-script
module.exports
导出为多种类型:
image
output
image
module--rule--loader
module
主要是根据rule
(规则)来配置loader
(插件)
解析resolve
webpack
在启动后会从配置的入口模块触发找出所有依赖的模块,Resolve
配置webpack
如何寻找模块对应的文件。webpack
内置JavaScript
模块化语法解析功能,默认会采用模块化标准里约定好的规则去寻找,但你可以根据自己的需要修改默认的规则。
下面介绍几个常用的配置项
1.
alias
:配置项通过别名来把原导入路径映射成一个新的导入路径。
- 例如使用以下配置:
resolve:{
alias:{
components: './src/components/'
}
}
- 当你通过
import Button from 'components/button'
导入时,实际上被alias
等价替换成了import Button from './src/components/button'
- 配置根目录
resolve:{
alias:{
'@': resolve('src'),
}
}
- 还有很多种配置方式,请参看官网
2.
mainFields
:有一些第三方模块会针对不同环境提供几分代码。 例如分别提供采用ES5
和ES6
的2份代码,这2份代码的位置写在package.json
文件里,如下:
{
// 采用 ES6 语法的代码入口文件
"jsnext:main": "es/index.js",
// 采用 ES5 语法的代码入口文件
"main": "lib/index.js"
}
-
Webpack
会根据mainFields
的配置去决定优先采用那份代码,mainFields
默认如下:
mainFields: ['browser', 'main']
-
Webpack
会按照数组里的顺序去package.json
文件里寻找,只会使用找到的第一个。 - 假如你想优先采用
ES6
的那份代码,可以这样配置:
mainFields: ['jsnext:main', 'browser', 'main']
3.
extensions
:在导入语句没带文件后缀时,Webpack
会自动带上后缀后去尝试访问文件是否存在。resolve.extensions
用于配置在尝试过程中用到的后缀列表,默认是:
extensions: ['.js', '.json']
- 也就是说当遇到
require('./data')
这样的导入语句时,Webpack
会先去寻找./data.js
文件,如果该文件不存在就去寻找./data.json
文件, 如果还是找不到就报错。 - 假如你想让
Webpack
优先使用目录下的TypeScript
文件,可以这样配置:
extensions: ['.ts', '.js', '.json']
4.
modules
:resolve.modules
配置Webpack
去哪些目录下寻找第三方模块,默认是只会去node_modules
目录下寻找。
- 有时你的项目里会有一些模块会大量被其它模块依赖和导入,由于其它模块的位置分布不定,针对不同的文件都要去计算被导入模块文件的相对路径,这个路径有时候会很长,就像这样
import '../../../components/button'
这时你可以利用modules
配置项优化,假如那些被大量导入的模块都在./src/components
目录下,把modules
配置成
modules:['./src/components','node_modules']
- 后,你可以简单通过
import 'button'
导入。
5.
descriptionFiles
:
resolve.descriptionFiles
配置描述第三方模块的文件名称,也就是package.json
文件。默认如下:
descriptionFiles: ['package.json']
6.
enforceExtension
:如果配置为true
所有导入语句都必须要带文件后缀, 例如开启前import './foo'
能正常工作,开启后就必须写成import './foo.js'
7.
enforceModuleExtension
:和enforceExtension
作用类似,但它只对node_modules
下的模块生效。
- 通常搭配
enforceExtension
使用,在enforceExtension:true
时,因为安装的第三方模块中大多数导入语句没带文件后缀, 所以这时通过配置enforceModuleExtension:false
来兼容第三方模块。
插件plugins
优化(optimization)
从 webpack 4
开始,会根据你选择的 mode
来执行不同的优化,不过所有的优化还是可以手动配置和重写。
devServer
image
webpack-dev-server
能够用于快速开发应用程序
下面就proxy做个解释:
- 假设你主机名为
localhost:8080
, 请求 API 的url
是http://your_api_server.com/user/list
-
'/proxy'
:如果点击某个按钮,触发请求 API 事件,这时请求url
是http://localhost:8080/proxy/user/list
。 -
changeOrigin
:如果true
,那么http://localhost:8080/proxy/user/list
变为http://your_api_server.com/proxy/user/list
。但还不是我们要的url
。 -
pathRewrite
:重写路径。匹配/proxy
,然后变为''
,那么url
最终为http://your_api_server.com/user/list
。
devtool
此选项控制是否生成,以及如何生成
source map
。
7中SourceMap
模式
模式 | 解释 |
---|---|
eval | 每个module会封装到 eval 里包裹起来执行,并且会在末尾追加注释 //@ sourceURL. |
source-map | 生成一个SourceMap文件. |
hidden-source-map | 和 source-map 一样,但不会在 bundle 末尾追加注释. |
inline-source-map | 生成一个 DataUrl 形式的 SourceMap 文件. |
eval-source-map | 每个module会通过eval()来执行,并且生成一个DataUrl形式的SourceMap |
cheap-source-map | 生成一个没有列信息(column-mappings)的SourceMaps文件,不包含loader的 sourcemap(譬如 babel 的 sourcemap) |
cheap-module-source-map | 生成一个没有列信息(column-mappings)的SourceMaps文件,同时 loader 的 sourcemap 也被简化为只包含对应行的。 |
- 注1:webpack 不仅支持这 7 种,
而且它们还是可以任意组合上面的eval、inline、hidden关键字,
就如文档所说,你可以设置 souremap 选项为:
cheap-module-inline-source-map。
- 注2:如果你的modules里面已经包含了SourceMaps,
你需要用source-map-loader 来和合并生成一个新的 SourceMaps。
统计信息stats
即:构建时命令行的日志显示方案
其他配置
- 构建目标(
targets
)告知webpack
为目标(target
)指定一个环境。默认为web
:编译为类浏览器环境里可用。 - 监听模式(
watch
)默认为false;若为true,则可配置watchOptions
- 外部扩展(
externals
):配置选项提供了「从输出的bundle
中排除依赖」;可将公共模块如loadsh
/jquery
等配置在这里 - 性能(
performance
):配置如何展示性能提示 - 其他......