React Native库安装后是否需全部链接？未链接会有何后果？

嘿，我在React Native开发中也碰到过类似的疑惑，甚至踩过相关的坑，来给你详细拆解下这个问题：

首先得明确React Native的库其实分两类，不同类型的库“未链接”的影响完全不一样：

1. 纯JavaScript实现的库（比如你提到的react-native-swipeable） #

这类库根本没有iOS/Android原生代码，本质就是一堆JS文件，npm/yarn安装后，React Native的打包器Metro能直接识别并加载它们。

• 未链接的后果：完全没有任何问题，因为这类库从设计上就不需要链接操作，文档里没提链接要求是完全合理的，放心用就行。

2. 包含原生代码的库（比如native-base这类） #

这类库有部分功能依赖iOS/Android原生模块实现，链接操作的本质是让你的原生项目（iOS的Xcode工程、Android的Gradle工程）能找到并引用这些原生代码。这里又分两种情况：

情况A：库适配了React Native自动链接（Auto-Linking） #

React Native 0.60版本之后自带了自动链接功能，绝大多数主流库（包括现在的native-base）都已经适配了这个机制。

• 你以为自己“没链接”，但实际上Metro和原生项目的构建脚本已经在打包/编译时自动完成了链接操作。
• 你手动运行react-native link时出现报错，大概率是因为自动链接已经做了正确的配置，手动链接的重复操作反而导致了配置冲突（比如重复添加了原生依赖）。而App能正常运行，恰恰说明自动链接已经生效了。
• 这种情况下未手动链接的后果：不仅没影响，反而可能避免了手动配置的冲突问题。

情况B：库未适配自动链接，且你完全没做链接操作 #

这种情况就容易出问题了，而且问题可能不会立刻显现：

• 运行时崩溃：当你的JS代码调用到依赖原生实现的功能时，App会直接崩溃，通常会抛出类似Native module cannot be null或者找不到某个原生方法的错误。
• 部分功能失效：如果库只有部分功能依赖原生代码，那只有用到那部分功能时才会出问题——比如某个UI组件的下拉刷新用了原生实现，没链接的话刷新功能就完全失效，或者显示异常。
• 构建失败：有些库的原生代码需要在项目配置中添加依赖（比如iOS的Pods、Android的Gradle依赖），没链接的话，在编译原生项目时就会报错，比如找不到某个类、方法，或者出现链接器错误。

总结一下 #

• 先判断库类型：看库的文档，或者去node_modules里对应库的目录下，有没有ios/android文件夹——没有的话就是纯JS库，不用管链接。
• 带原生代码的库：React Native 0.60+优先依赖自动链接，别随便手动跑react-native link；如果库明确要求手动链接但你没做，就会出现上述的崩溃、功能失效或构建失败问题。

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