React Native依赖选取机制及Turbo Modules兼容场景咨询

一、包本地依赖与项目依赖的使用场景 #

1. 使用包本地依赖的场景 #

• 包有独立的版本需求：如果第三方包的package.json指定了某个依赖的特定版本，且和项目根目录的依赖版本不兼容，npm/yarn会在包自己的node_modules下安装该依赖，保证包能正常运行。
• 存在版本冲突：当项目根依赖和包的依赖版本要求冲突时，包会优先用本地安装的依赖，避免版本不匹配导致报错（比如项目用react@17，但某个包必须用react@16，此时包会在本地装react@16）。
• 需要专属工具链依赖：一些包会依赖特定版本的构建工具（比如babel-plugin-transform-runtime），这些工具只服务于包自身的编译，不会影响项目全局，因此会装在包的本地node_modules里。
• peer依赖未被项目满足：如果包声明了peer依赖，但项目没安装对应版本，部分包会降级使用本地安装的该依赖（不过现在npm默认会发出警告，需要手动处理）。

2. 使用项目根依赖的场景 #

• 版本兼容且已被项目安装：当包的依赖版本范围和项目根目录的依赖版本匹配时，npm/yarn会做依赖扁平化，共享项目根的依赖，不会在包本地重复安装。
• 包声明了peer依赖：如果包的package.json里声明了peer依赖（比如"peerDependencies": {"react-native": ">=0.68.0"}），它会直接用项目根目录安装的对应依赖，不会自己本地安装——peer依赖的设计就是让包复用宿主项目的依赖。
• 全局或项目根的工具类依赖：比如npm、yarn这类全局工具，或者项目根目录安装的react-native-cli，包会直接调用项目或全局的版本，不会本地安装。

二、未启用Turbo Modules的第三方库为何使用本地依赖 #

• 版本兼容性隔离：即使项目启用了新架构，未适配Turbo Modules的库可能依赖旧版本的React Native核心依赖（比如react-native-codegen、hermes-engine的特定版本），如果项目根的这些依赖版本和库要求的不一致，库会用本地安装的版本，避免新架构的依赖破坏旧库的运行逻辑。
• 旧架构的依赖需求：未适配Turbo Modules的库基于旧架构的原生模块系统开发，它的build.gradle（Android）或Podfile（iOS）可能依赖特定版本的原生依赖（比如com.facebook.react:react-native的旧版本），这些依赖会被安装在库的本地node_modules对应的原生目录下，确保旧架构的模块能正常编译和运行。
• 依赖扁平化失败：如果项目根的依赖和库的依赖存在版本冲突（比如项目用新架构要求的react-native@0.72，但库只支持react-native@0.70），npm/yarn无法进行依赖扁平化，只能在库本地安装兼容的依赖版本，保证库能正常工作。
• 库自身的构建逻辑：有些旧库的构建脚本（比如postinstall钩子）会强制安装本地依赖，确保自己的编译环境不受项目根依赖的影响，这种情况下不管项目依赖如何，库都会使用本地版本。

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