为何在React组件库中添加forwardRef需视为破坏性变更？

React文档明确要求：当组件库为组件添加forwardRef时，该变更需视为破坏性变更，并发布新的主版本。很多开发者会疑惑——明明只是新增了接收ref的能力，按语义化版本（semver）看起来像是小版本的功能更新，为什么要这么定义？

1. TypeScript类型兼容性断裂 #

这是最直接的原因：

• 未使用forwardRef的函数组件，默认类型是React.FC/React.FunctionComponent，这类组件的props中不包含ref字段，如果用户代码错误传递ref，TypeScript会直接报错（开发模式下React也会弹出警告）。
• 改用forwardRef后，组件类型变为React.ForwardRefExoticComponent，它允许ref作为独立参数传入。这会导致原本依赖旧类型的用户代码出现编译错误——比如之前用React.FC约束该组件的地方，现在会因类型不匹配失败，只有显式声明为React.FC<any>才能绕过检查。

2. 运行时行为的隐性变更 #

即使不使用TypeScript，运行时也存在潜在的破坏性：

• 未加forwardRef时，用户如果强行传递ref（比如通过ref属性），React会忽略这个ref并在开发模式警告，但组件渲染逻辑不受影响。
• 添加forwardRef后，这个ref会被传递给内部的SomeJsx组件，原本被忽略的ref突然生效，可能引发意外行为。比如用户之前误传了ref，原本只是有警告，现在ref会绑定到内部DOM元素/组件，干扰原有的DOM操作逻辑。

3. 语义化版本的严格规则 #

语义化版本（semver）中，破坏性变更的定义是「会导致现有代码无法正常工作或行为改变的变更」，并非仅指功能移除：

• 虽然添加forwardRef是新增功能，但它改变了组件对ref属性的处理逻辑，同时破坏了类型兼容性，完全符合semver中主版本（major）变更的要求。

内容的提问来源于stack exchange，提问作者Sean Monahan