渐进式迁移
逐步采用 TS：启用检查，使用 JSDoc 添加类型注释，优先迁移关键文件，并在过渡期间保持构建通过。
渐进式迁移 是 CoddyKit 上的免费 React Academy 课时。 这是第 3 节课，共 3 节。 你可以在下方免费阅读本课时的完整内容 — 然后在浏览器中使用内置代码编辑器和全天候 AI 导师进行实践。 这是 React Academy 学习路径的一部分，你的进度在网页和 CoddyKit 应用中同步。 React Academy 课程共包含 3 节课。
为什么要渐进式迁移？
目标：在迁移过程中持续交付。
- 添加检查而不破坏构建
- 使用 JSDoc 添加注释
- 优先迁移高频修改的文件
规划迁移
- 从 JS 文件中的 JSDoc 开始
- 保持改动小而渐进；一次处理一个组件
- 优先处理经常编辑的文件
- 使用类型别名复用结构
第 1 步：通过 JSDoc 为属性添加类型
添加 JSDoc 来记录属性，无需重命名文件。
<div id="root"></div>第 2 步：复用共享类型定义
提取共享的类型定义，并在各处复用。
<div id="root"></div>第 3 步：运行时保护检查模式
使用小型保护检查，确保迁移过程中的运行时安全。
<div id="root"></div>技巧与检查清单
- 逐个文件迁移；保持 PR 较小
- 现在添加 JSDoc；稍后再重命名为 TS
- 类型稳定下来之前，使用小型保护检查
渐进式迁移检查
回顾
回顾：先在 JS 文件中使用 JSDoc，提取共享类型定义，添加小型运行时保护检查，准备好后再将高频修改的文件重命名为 TS。
常见问题解答
「渐进式迁移」课时是免费的吗？
是的 — 「渐进式迁移」的完整文本可在网页上免费阅读。要进行交互式练习（内置代码编辑器和全天候 AI 导师）并解锁 React Academy 课程的其余内容，请升级到 CoddyKit PRO。 React Academy 课程共包含 3 节课。
「渐进式迁移」这节课中我会学到什么？
逐步采用 TS：启用检查，使用 JSDoc 添加类型注释，优先迁移关键文件，并在过渡期间保持构建通过。 你通过在浏览器中直接运行的动手代码来练习 React Academy，全天候 AI 导师会在你学习这节课的过程中回答你的问题。
学习 React Academy 需要有经验吗？
无需任何先前经验。CoddyKit 上的 React Academy 课程适合初学者到高级学习者，你可以从这里开始或从头开始，按照自己的节奏学习。 这是第 3 节课，共 3 节。
「渐进式迁移」课时需要多长时间？
大多数 CoddyKit 课程大约需要 5–10 分钟。每节课都很精短且互动，所以你能稳步进步，并在网页和应用中从离开的地方继续。
我能在这节 React Academy 课中编写并运行代码吗？
能。每节 React Academy 课都包含内置代码编辑器，你可以在浏览器中直接编写并运行真实代码，并获得即时 AI 反馈 — 无需本地设置。