Floating-ui项目中React依赖问题的技术解析

在Floating-ui工具库的utils包中，存在一个关于React依赖的技术问题值得开发者关注。作为一套跨框架的UI定位工具库，Floating-ui的设计初衷是支持包括Vue、React在内的多种前端框架。

问题的核心在于utils包中不必要地声明了React作为peer dependency。peer dependency是一种特殊的依赖关系，它表示当前包需要宿主环境提供指定版本的依赖包。在utils包的场景下，这个声明显得不合时宜，原因有二：

首先，经过代码审查发现，utils包的核心功能完全不依赖React的任何特性。该包主要提供基础的DOM操作、位置计算等与框架无关的工具函数，这些功能完全可以独立于React运行。

其次，这种声明会给非React生态的开发者带来困扰。例如Vue开发者在使用该工具时，会不必要地在项目中引入React依赖，这不仅增加了包体积，还可能引发版本冲突等问题。

这个问题源于项目历史原因。在早期的代码结构中，React依赖关系没有被显式声明。但在最近一次的turborepo重构后，这个隐藏的依赖关系被意外暴露出来。项目维护团队已经意识到这个问题，并在相关PR中进行了修正。

对于使用Floating-ui的开发者来说，这个问题提醒我们：在使用跨框架工具库时，应该注意检查其依赖关系是否真正符合项目需求。特别是peer dependency的声明，往往会影响整个项目的依赖树结构。

作为最佳实践，工具库开发者应当：

1. 严格区分框架相关和框架无关的代码
2. 合理使用peer dependency
3. 定期审查依赖关系声明
4. 对跨框架支持的功能进行明确标注

Floating-ui团队对此问题的快速响应也展示了开源项目维护的良好实践，值得其他项目借鉴。