React Native本地依赖包安装报错：无法解析ExamplePackage模块

我之前踩过一模一样的React Native本地包引入的坑，给你几个亲测有效的解决方向：

• 检查本地包的核心配置
  React Native的Haste模块系统完全依赖包的package.json配置，你要确认：

  • ExamplePackage根目录的package.json里的name字段完全等于你引入时的ExamplePackage（大小写敏感！别写错）
  • 本地包要么有根目录的index.js入口文件，要么在package.json里通过main字段指定了正确的入口路径，比如"main": "./src/index.js"

• 彻底清除缓存并重启服务
  React Native的缓存经常会导致模块解析异常，执行以下命令清空缓存并重建依赖：

  rm -rf node_modules && npm install
  npx react-native start --reset-cache
  npx react-native run-ios # 对应Android则用npx react-native run-android
  

  如果还是不行，修改项目根目录的metro.config.js，手动指定本地包的路径映射：

  const { getDefaultConfig, mergeConfig } = require('@react-native/metro-config');
  
  const customConfig = {
    resolver: {
      extraNodeModules: new Map([
        ['ExamplePackage', require.resolve('../../ExamplePackage')]
      ])
    }
  };
  
  module.exports = mergeConfig(getDefaultConfig(__dirname), customConfig);
  

  这个配置会告诉Metro明确去哪里找你的本地包，绕开Haste的自动映射问题。

• 改用npm link关联本地包
  多级相对路径安装本地包容易出现解析异常，更稳妥的方式是用npm软链接：

  1. 进入ExamplePackage的根目录，执行：npm link
  2. 回到你的项目根目录，执行：npm link ExamplePackage
     这样相当于在全局建立了包的关联，React Native的模块解析会更稳定，而且本地包代码修改后能实时同步到项目里。

• 核对版本兼容性
  部分旧版本的React Native或Metro对本地包的解析逻辑有bug，确保你的项目和ExamplePackage使用的React Native版本尽量接近，避免因版本差异导致的解析失败。

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