用 AI 迁移代码
用映射表 + 逐文件验证跨框架/语言迁移代码。
文档与重构高级
为什么
GitHub 2024 调查发现 81% 的开发者预期 AI 工具未来一年在代码文档中更深度集成，为所有工作流中最高。迁移（JS→TS、Express→Hono、REST→tRPC）机械但易错。
有显式旧→新映射表的 AI 做机械部分；你用测试验证每文件。
何时使用
有清晰映射的框架/语言迁移用此。需重设计的范式转移跳过。
如何做
1. 建旧→新映射表（API、模式、类型）。
2. 提示："按表迁移此文件；保行为；标记表中无的内容"。
3. 每文件一 commit 迁移；每次后跑测试。
4. 未映射模式：手动决定，加到表。
5. 末尾跑完整门禁。
示例
映射：Express → Hono
app.get(path, handler) → app.get(path, (c) => handler(c.req, c))
req.body → c.req.json()
res.json(x) → c.json(x)
提示："按表迁移 routes/users.ts；保行为；标记任何未匹配。"
每路由文件一 commit 迁移；测试门控每步。
常见问题
- ⚠重构后 Error: Cannot find module 'xxx' → 重跑 `npm install` 和 `npx tsc --noEmit`；重构常丢或重命名 import。
- ⚠错误：重构后 "Cannot read properties of undefined" → 跑测试套件（`npm test`）捕获行为变更；重构须保持行为。
- ⚠错误：文档漂移：示例无法运行 → 在 CI 执行示例（`npm run docs:check`）；被测示例不会漂移。
最佳实践
- ✓先建映射表；逐文件迁移用测试门控每步。
- ✓标记表中无的内容而非猜。
- ✓用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。
常见问题解答
什么是用 AI 迁移代码？
用映射表 + 逐文件验证跨框架/语言迁移代码。 它可帮助开发者快速理解 用 AI 迁移代码 的核心价值与适用场景。
如何开始使用用 AI 迁移代码？
开始使用 用 AI 迁移代码，建议先掌握以下要点：建旧→新映射表（API、模式、类型）。
用 AI 迁移代码 的常见误区有哪些？
使用 用 AI 迁移代码 时常遇到的问题包括：重构后 Error: Cannot find module 'xxx' → 重跑 `npm install` 和 `npx tsc --noEmit`；重构常丢或重命名 import。；错误：重构后 "Cannot read properties of undefined" → 跑测试套件（`npm test`）捕获行为变更；重构须保持行为。；错误：文档漂移：示例无法运行 → 在 CI 执行示例（`npm run docs:check`）；被测示例不会漂移。。
用 AI 迁移代码 的最佳实践是什么？
用 AI 迁移代码 的最佳实践包括：先建映射表；逐文件迁移用测试门控每步。；标记表中无的内容而非猜。；用具体指标衡量结果（节省时间、缺陷率、测试覆盖率），使实践可被论证和改进。。
如何深入学习用 AI 迁移代码？
从官方文档入手，再在 GitHub 上搜索真实示例；先在小实验仓库验证模式，再应用到生产代码。