Windows本地开发React Native库时metro.config黑名单路径配置问题

我之前在跨平台开发RN本地库时也遇到过一模一样的路径正则和模块冲突问题，给你几个经过验证的解决方案，应该能帮你搞定：

方案1：用Metro的blockList+跨平台路径转义（最直接的配置方式） #

Metro现在推荐用blockList代替旧版的blacklistRE，我们可以借助Node.js的工具来生成全平台兼容的规则：

1. 先在example项目里安装路径转义的工具包：

npm install escape-string-regexp --save-dev

2. 修改example目录下的metro.config.js：

const path = require('path');
const escapeRegExp = require('escape-string-regexp');

// 定位到库根目录下的react-native文件夹
const libraryReactNativePath = path.resolve(__dirname, '../node_modules/react-native');
// 转义路径里的特殊字符（比如Windows的反斜杠），确保正则能正确匹配
const escapedPath = escapeRegExp(libraryReactNativePath);

module.exports = {
  transformer: {
    getTransformOptions: async () => ({
      transform: {
        experimentalImportSupport: false,
        inlineRequires: true,
      },
    }),
  },
  // 把库目录下的react-native及其所有子文件/文件夹加入黑名单
  blockList: [new RegExp(`^${escapedPath}\\/.*$`)],
};

这个方法的关键是用escape-string-regexp把路径里的特殊字符（比如Windows的\、类Unix的/以及可能的特殊符号）全部转义，生成的正则在任何平台都能精准匹配目标目录。

方案2：手动重定向React Native模块解析（绕过正则问题） #

如果还是搞不定正则，我们可以直接拦截Metro的模块请求，强制它只加载example项目里的React Native：

修改metro.config.js如下：

const path = require('path');

module.exports = {
  // 让Metro监听库目录的代码变化，保证调试时能实时更新
  watchFolders: [path.resolve(__dirname, '..')],
  resolver: {
    resolveRequest: (context, moduleName, platform) => {
      // 当请求react-native模块时，直接指向example自己的版本
      if (moduleName === 'react-native') {
        const localRnPath = path.resolve(__dirname, 'node_modules/react-native/index.js');
        return {
          filePath: localRnPath,
          type: 'sourceFile',
        };
      }
      // 其他模块按默认逻辑处理
      return context.resolveRequest(context, moduleName, platform);
    },
  },
  // 保留你原有的transformer等配置...
};

这个方案跳过了黑名单的正则配置，从模块解析的根源解决冲突，非常适合对正则不太熟悉的情况。

方案3：用yalc管理本地包链接（长期开发首选） #

如果需要频繁调试本地库，手动配置metro太折腾，推荐用yalc工具来模拟npm包的本地发布，它会自动处理依赖冲突：

1. 全局安装yalc：

npm install -g yalc

2. 在你的my-library目录下执行：

yalc publish

3. 切换到example目录，把本地库添加进来：

yalc add my-library

4. 启动example项目即可，yalc会帮你处理依赖解析，完全避免React Native重复加载的问题。

这个方法不仅解决了当前的冲突，还能模拟真实的npm包安装场景，适合长期维护和调试RN库。

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