React 19 适配

[YannLynn]

关于 Semi Design 对 React 19 的支持计划(About Semi Design's support plan for React 19)

感谢社区对 Semi Design 与 React 19 兼容性的关注。我们非常重视这一需求，并已将 React 19 的全面适配纳入我们的产品路线图。
Thank you for the community's attention to the compatibility of Semi Design with React 19. We take this demand very seriously and have included full adaptation of React 19 in our product roadmap.

时间规划(Time Planning)

我们计划在 2025 年第三季度 进行 React 19 的全面适配与优化工作。选择这一时间点是基于以下考虑：

1. React 19 有较多 breaking change：这些 breaking change 无法以兼容的方式在我们的版本中继续支持。我们全面支持 19 会对现存项目造成很多破坏性更新，我们需要重点考量字节内部项目/社区存量项目的升级成本，在现阶段 v19 的用户群体还不是特别多，会更优先考虑v18及以下版本的使用体验。
2. 完善的测试与文档：确保升级后的 Semi 组件库能为用户提供稳定可靠的体验

We plan to fully adapt and optimize React 19 in the third quarter of 2025. This time point was chosen based on the following considerations:

1. React 19 has many breaking changes: these breaking changes cannot be supported in our version in a compatible way. Our full support for 19 will cause many destructive updates to existing projects. We need to focus on the upgrade costs of ByteDance internal projects/community existing projects. At this stage, the user group of v19 is not particularly large, and we will give priority to the user experience of v18 and below versions.
2. Complete testing and documentation: Ensure that the upgraded Semi component library can provide users with a stable and reliable experience

当前建议(Current recommendations)

在我们正式发布 React 19 支持版本前：

• 对于已有项目，建议暂时保持使用 React 18
• 如有尝试 React 19 的需求，可以在非生产环境下进行初步测试，并欢迎将发现的任何兼容性问题反馈给我们

Before we officially release React 19 support:

• For existing projects, it is recommended to keep using React 18 for the time being
• If you need to try React 19, you can do preliminary testing in a non-production environment, and you are welcome to report any compatibility issues you find to us

参与和反馈(Participation and feedback)

我们非常欢迎社区参与 Semi 的 React 19 适配工作：

• 如果你已经在 React 19 环境下使用 Semi 并发现了问题，请提交 issue 并标记 react19
• 如有对适配工作的具体建议，欢迎在讨论区分享

We welcome the community to help Semi adapt to React 19:

• If you have used Semi in React 19 and found problems, please file an issue and tag react19
• If you have specific suggestions for adaptation, please share them in the discussion forum

感谢您的理解与支持。我们将在接下来的几个月中持续分享相关进展。
Thank you for your understanding and support. We will continue to share relevant progress in the coming months.

已知问题列表(Known Issues List)

• ReactDOM.render warning [BUG] Typograhy.Text component use ReactDom.render promotes console error #2699
• FindDOMNode warning 在 React.StrictMode 下无法使用  #201
• Deprecated: element.ref [BUG] <title>使用Navigation组件折叠菜单报错 #2736
• @douyinfe/semi-icons-lab support react19 [BUG] <title>找不到模块“@douyinfe/semi-icons-lab”或其相应的类型声明。 #2732

Semi Team

[pointhalo]

关于 findDOMNode，之前版本未做处理相关的解释：#201

[BleedingDev]

Awesome, glad it is planned! 😊

Will there be a list of known issues also with sign if it's already fixed in some way? My biggest problem is with findDOMNode and if that's fixed I am more than happy to provide feedback and running it in small app. :)

[shanliu]

这个有什么进度吗？大半年了。
./node_modules/.pnpm/@DouyinFE+semi-ui@2.83.0_acorn@8.15.0_react-dom@19.1.0_react@19.1.0__react@19.1.0/node_modules/@douyinfe/semi-ui/lib/es/resizeObserver/index.js 44:23-34
⚠ ESModulesLinkingWarning: export 'findDOMNode' (imported as 'findDOMNode') was not found in 'react-dom' (possible exports: __DOM_INTERNALS_DO_NOT_USE_OR_WARN_USERS_THEY_CANNOT_UPGRADE, createPortal, flushSync, preconnect, prefetchDNS, preinit, preinitModule, preload, preloadModule, requestFormReset, unstable_batchedUpdates, useFormState, useFormStatus, version)
╭─[44:23]
42 │ // 1. cloning to insert a ref is unwieldy and not performant.
43 │ // 2. ensure that we resolve to an actual DOM node (instead of any JSX ref instance).
44 │ return findDOMNode(this.childNode || this);
· ───────────
45 │ } catch (error) {
46 │ // swallow error if findDOMNode is run on unmounted component.