migrate-v8-to-v9

React v8 到 v9 迁移检查清单

开始前，运行 intent load @tanstack/table-core#migrate-v8-to-v9。检查其完整的共享检查清单，并阅读应用中涉及的 API 对应的详细核心映射。本检查清单补充了 React 特定的变更。

框架前提：React 18 或更高版本（react >=18）。

适配器审查

• 将 useReactTable 替换为 useTable；移除 @tanstack/react-table/legacy 中任何临时使用的 useLegacyTable。
• 保持模型输入稳定，并使用显式的 tableFeatures 及其行模型插槽。通过核心检查清单审查所有共享变更。
• 将渲染读取替换为选定的 table.state、table.Subscribe 或 useSelector。仅使用 Atom/Store 快照并不会让 React 订阅变更。
• 为每个受控的 state 分片配对提供其更新回调，或提供一个稳定的 React Store Atom。移除全局的 onStateChange 选项。
• 检查被编译器记忆化的子组件是否隐藏了对构建器方法的读取；在子组件内部订阅，或将选定的值传入子组件。
• 在适用处使用 table.FlexRender 或独立的 FlexRender；仍支持 flexRender。
• 仅在需要统一重复约定时引入 tableOptions 或 createTableHook；保留应用封装和类型化上下文边界。

查看受影响的详细信息

如果审查发现旧版 React 构建、状态、渲染或应用 Hook 代码，请在编辑前阅读适配器迁移详情。如需替换渲染脚手架，请阅读快速入门。如迁移后存在受控状态或过期状态，请阅读表格状态。

共享的固定、尺寸、排序、选择、原型方法、类型和注册表变更仍参见核心迁移参考。仅重命名 useReactTable 并不能完成迁移。

验证迁移

• 根据已安装的 v9 适配器进行类型检查，并测试每个已启用的客户端/手动功能流程。
• 验证外部状态写入、响应式数据替换，以及上述变更涉及的框架渲染路径。
• 完成核心检查清单；使用布局和选择功能时，也要检查其行为。
• 如果目标是显式功能树摇，则替换临时的 stockFeatures，并移除 useLegacyTable。

API 发现

检查 node_modules/@tanstack/react-table/dist/index.d.ts 和导出的适配器声明。共享 API 请查看 node_modules/@tanstack/table-core/dist/index.d.ts。