UmiJS 4 升级过程中 targets 配置问题解析

问题背景

在从 UmiJS 3 升级到 UmiJS 4 的过程中，开发者执行 max setup 命令时，在生成文件阶段遇到了一个与 Babel 相关的错误。错误信息明确指出 'false' is not a valid value for 'targets.edge'，这表明在项目的配置中存在不兼容的浏览器目标设置。

错误原因分析

这个错误源于项目配置中的 targets 对象包含了 edge: false 这样的设置。在 UmiJS 4 和 Babel 的新版本中，浏览器目标配置不再接受布尔值作为有效输入。这是一个常见的配置兼容性问题，特别是在跨大版本升级时。

解决方案

解决这个问题的方法很简单：

1. 检查项目中的配置文件（通常是 .umirc.ts 或 config/config.ts）
2. 找到 targets 配置项
3. 移除其中类似 edge: false 这样的布尔值设置
4. 可以完全移除该配置项，或者改为指定具体的 Edge 浏览器版本号

升级建议

对于 UmiJS 的大版本升级，建议采用以下策略：

1. 新建项目迁移：创建一个全新的 UmiJS 4 项目，然后逐步将原有代码迁移过去，而不是直接升级现有项目
2. 分步验证：每次迁移一部分功能后都进行验证，确保没有兼容性问题
3. 配置检查：特别注意检查所有自定义配置项，因为大版本升级往往伴随着配置格式的变化
4. 依赖兼容性：检查所有第三方依赖是否支持 UmiJS 4

技术细节

在 Babel 7 及更高版本中，@babel/preset-env 的 targets 配置要求更加严格。每个浏览器目标必须指定为：

• 版本号字符串（如 "edge": "18"）
• 百分比字符串（如 "edge": ">0.2%"）
• 或者完全省略该浏览器配置

布尔值 false 不再被接受作为有效的目标配置值，这是导致本次错误的技术根源。

总结

UmiJS 4 带来了许多改进和新特性，但在升级过程中需要注意配置兼容性问题。特别是浏览器目标配置这类与构建工具链深度集成的配置项，往往是大版本升级中容易出问题的地方。通过理解错误背后的原因，采用合理的升级策略，可以大大降低升级过程中的风险。