如何将自研React Native组件库导入到React Native项目中？

按适用场景和可维护性排序，优先级从高到低如下：

1. 发布为私有npm包（团队多项目长期复用最优方案） #

• 操作步骤：
  • 组件库单独作为一个npm包项目，配置好package.json的入口字段（比如main、module，如果有TS声明还要配置types字段）
  • 处理RN专属的打包配置：将react、react-native等核心依赖设置为peer依赖，避免业务项目中出现多份实例冲突
  • 发布到公司内部私有npm源（没有私有源的话也可以直接使用npm官方的私有包服务）
  • 业务项目直接执行npm install @你的组织名/组件库名即可导入使用
• 优势：
  • 版本管理清晰，支持语义化版本规则，不同业务项目可以按需选择组件库版本，避免强制升级引发的冲突
  • 安装使用成本极低，和使用开源第三方RN组件库的体验完全一致
  • 支持跨团队共享，权限可控
• 注意点：组件库修改后需要走发布流程，实时调试可以配合npm link或者下面的软链接方案临时使用

2. Monorepo 统一管理（组件库和业务项目同步迭代优先选） #

如果你的组件库和多个业务项目都在同一个代码仓库维护，用Monorepo架构是最优选择：

• 操作步骤：
  • 用pnpm workspace、yarn workspace或者lerna管理Monorepo，把组件库作为其中一个子包，所有业务项目作为其他子包
  • 在业务项目的package.json中直接依赖本地的组件库子包即可，包管理器会自动处理软链接关联
• 优势：
  • 组件库修改后所有关联的业务项目能实时生效，不需要发布npm包，调试效率极高
  • 统一管理依赖版本，避免多项目依赖版本不一致引发的兼容问题
  • 适合组件库和业务项目并行开发、频繁迭代的场景
• 注意点：Monorepo配置有一定学习成本，项目体量过大时安装、构建速度会受到影响

3. 本地软链接（仅适用于开发调试临时场景） #

如果只是临时调试组件库修改，不想走发布流程或者配置Monorepo，可以用软链接方案：

• 操作步骤：
  • 在组件库项目根目录执行npm link
  • 在业务项目根目录执行npm link 组件库名即可完成本地关联
• 优势：配置简单，不需要额外的基础设施，修改组件库代码可以实时同步到业务项目
• 注意点：仅适合本地开发用，不要用在生产环境，容易出现依赖实例重复、路径解析错误等问题，也不支持版本管理

通用避坑提醒：所有方案都要把react、react-native配置为组件库的peerDependencies，不要打包到组件库产物里，否则业务项目运行时会出现多份React实例冲突、Hooks报错等常见问题。

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