将 Rsbuild 1.x 项目升级到 v2 时…

适用于需要把现有 Rsbuild 1.x 项目迁移到 v2，并按官方指南处理破坏性变更与构建验证的场景。

适用场景

解决思路

1. 确认当前设置：读取 package.json，识别项目中使用的 Rsbuild 和插件包。
2. 确认当前设置：定位 Rsbuild 配置文件（常见为 rsbuild.config.(ts|js|mjs|cjs)）。
3. 打开官方升级指南：以 v1 → v2 指南作为唯一事实来源：https://rsbuild.rs/guide/upgrade/v1-to-v2
4. 制定升级路径：将当前项目配置与迁移指南进行对比。
5. 制定升级路径：列出适用于项目当前配置和插件的破坏性变更。
6. 制定升级路径：记录被移除或重命名的选项、默认值以及插件 API。
7. 更新依赖：将 @rsbuild/core 升级到 v2。
8. 更新依赖：通过 npx taze major --include /rsbuild/ -w -r 将 Rsbuild 插件升级到最新版本。
9. 应用配置与代码变更：更新 Rsbuild 配置，使其匹配 v2 的选项和默认值。
10. 应用配置与代码变更：删除已废弃或不再支持的设置。
11. 验证：运行构建和开发命令。
12. 验证：运行项目测试或类型检查。
13. 验证：修复新版本暴露出的任何警告或错误。

适用边界 · 注意事项

• 不适用于非 Rsbuild 项目，或未使用 Rsbuild 1.x 的项目。
• 不适用于不需要跨主版本迁移、仅做 Rsbuild v2 内小版本升级的场景。
• 如果无法访问官方 v1 → v2 升级指南，或无法修改 package.json 与配置文件，则不应直接套用此流程。