webpack配置编写条件逻辑:导出函数时build模式参数为undefined的排查
核心原因
webpack对导出函数形式的配置文件有固定的参数注入规则,和多数人默认的传参逻辑有差异,你拿到undefined本质是没有匹配这套规则。
- webpack在加载配置函数时,会按固定顺序注入两个入参:
- 第一个参数是通过CLI的
--env参数透传的环境键值对象,webpack本身不会自动把构建模式mode的值塞进这个参数 - 第二个参数是CLI选项对象,包含所有你通过命令行传入的构建选项(包括
mode值)
- 第一个参数是通过CLI的
- 触发参数为undefined的常见场景:
- 没有通过webpack官方CLI、webpack-dev-server的内置配置加载流程执行构建,而是自己在普通Node脚本里手动
require配置文件后直接调用导出的函数——这种场景下没有内置逻辑帮你传参,所有入参自然都是undefined - 部分老旧脚手架的自定义配置加载逻辑,没有按照webpack官方规范实现参数注入流程,也会导致拿到的入参为undefined
- 没有在构建命令里通过
--env前缀传递任何自定义环境变量,第一个env参数的初始值不符合预期 - 使用了webpack 4以下的老旧版本,该版本根本不支持导出函数的配置写法,不存在参数注入逻辑
- 没有通过webpack官方CLI、webpack-dev-server的内置配置加载流程执行构建,而是自己在普通Node脚本里手动
正确实现方式
- 要拿到构建模式值,不需要额外传递
--env参数,直接从函数的第二个入参读取即可:// 入参顺序固定:第一个为env环境对象,第二个为argv命令行选项对象 module.exports = function (env, argv) { // 直接从argv中读取--mode传入的构建模式 const isDev = argv.mode === 'development' return { // 条件化配置示例 devtool: isDev ? 'inline-source-map' : false, optimization: { minimize: !isDev } } } - 如果确实需要使用第一个
env入参,需要在构建命令里主动通过--env前缀传入自定义键值,否则该参数不会被自动填充业务值:
这个时候函数的第一个入参才会拿到# 执行构建时主动传env参数 webpack --mode production --env apiHost="https://prod.example.com"{ apiHost: "https://prod.example.com" }的对象。
内容的提问来源于stack exchange,提问作者Guerrilla
相关产品推荐
相关产品推荐

