React Native本地库引入失败：无法解析模块问题求助

我太懂这种反复折腾缓存清理却还是卡壳的挫败感了——本地库的模块解析问题有时候确实比远程包棘手得多。咱们一步步拆解可能的问题点，帮你搞定这个报错：

1. 先核对本地库的核心配置 #

• 首先确认你的本地库react-native-first-library根目录下的package.json，name字段必须和主项目依赖里的react-native-first-library完全一致（大小写、拼写都不能差），Metro对这个敏感度拉满。
• 再检查main字段有没有正确指向库的入口文件（比如index.js或者src/index.js），如果这个路径写错了，Metro就算找到包也找不到真正的入口。

2. 验证本地库的文件结构和导出 #

• 确保本地库的入口文件真实存在，而且导出逻辑正确。比如如果是组件库，入口里得有类似export default MyFirstComponent;的导出，主项目才能正常import。
• 如果本地库自己也有node_modules，建议直接删掉——主项目会统一管理依赖，本地库的依赖包很容易和主项目的产生冲突。

3. 调整Metro的监听配置 #

React Native 0.60+的Metro默认不会自动解析上级目录的本地包，你需要在主项目的metro.config.js里添加watchFolders配置，把本地库的路径加进去：

const path = require('path');
module.exports = {
  transformer: {
    getTransformOptions: async () => ({
      transform: {
        experimentalImportSupport: false,
        inlineRequires: false,
      },
    }),
  },
  watchFolders: [
    path.resolve(__dirname, '../react-native-first-library'), // 本地库的绝对路径
  ],
};

改完配置后，一定要带着--reset-cache参数重启Metro：yarn start --reset-cache

4. 检查原生端配置（如果你的库包含原生代码） #

如果本地库有iOS/Android原生模块，仅靠npm link可能不够：

• iOS端：进入主项目ios目录执行pod install，确保本地库的pod被正确安装；也可以检查Podfile里是否自动引入了你的本地库（0.60+的autolink一般会处理，但手动确认更稳妥）。
• Android端：检查主项目android/settings.gradle里是否包含：

  include ':react-native-first-library'
  project(':react-native-first-library').projectDir = new File(rootProject.projectDir, '../react-native-first-library/android')
  

  再确认android/app/build.gradle的dependencies里有implementation project(':react-native-first-library')（autolink应该会自动添加，还是检查下放心）。
• 做完原生配置检查后，记得重新编译原生项目：iOS用Xcode clean后重新构建，Android执行./gradlew clean再重新运行。

5. 最后来一次彻底的缓存清理 #

有时候缓存清理需要更彻底，按这个顺序来：

• 关闭所有Metro服务、模拟器/真机
• 执行watchman watch-del-all
• 删除主项目的node_modules和yarn.lock/package-lock.json
• 删除本地库的node_modules（如果之前没删的话）
• 主项目执行yarn install或npm install
• 执行yarn start --reset-cache，等Metro完全重启
• 重新运行你的React Native项目

另外提个小细节：主项目里import的时候，是不是用的import MyComponent from 'react-native-first-library';？别用相对路径，既然已经把它作为依赖包安装了，直接用包名导入才是正确姿势。

如果以上步骤都试过还是不行，可以试试用yarn link重新关联：

• 在本地库目录执行yarn link
• 在主项目目录执行yarn link react-native-first-library
  然后再重启Metro试试。

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