如何让Expo/React Native忽略未使用的Node.js fs、os模块

我明白你遇到的困扰了——虽然你根本没用到本地模块里依赖fs和os的函数，但Expo的Metro打包器还是会扫描整个模块的依赖链，尝试解析这些Node.js核心模块，导致报错。下面几种实用方法可以帮你让打包器忽略这些未使用的模块：

方法1：通过Metro配置Mock掉目标模块 #

Metro允许我们自定义模块解析逻辑，把fs和os映射到一个空的mock模块，这样打包器就不会去寻找原生Node.js模块了。

1. 在项目根目录创建或修改metro.config.js，添加以下配置：

const { getDefaultConfig } = require('expo/metro-config');

const config = getDefaultConfig(__dirname);

// 把fs和os映射到自定义的空mock模块
config.resolver.extraNodeModules = {
  ...config.resolver.extraNodeModules,
  fs: require.resolve('./empty-mock.js'),
  os: require.resolve('./empty-mock.js'),
};

module.exports = config;

2. 在项目根目录创建empty-mock.js文件，内容只需要一个空导出：

module.exports = {};

这样配置后，Metro在解析fs或os时，会直接加载这个空mock模块，不会再抛出无法解析的错误。

方法2：用Babel插件移除未使用的模块导入 #

如果你的本地模块里明确导入了fs和os但完全没用到，我们可以用Babel插件直接把这些无用的导入从代码里移除，让打包器根本看不到它们。

1. 先安装对应的Babel插件：

npm install babel-plugin-transform-remove-imports --save-dev

2. 修改项目根目录的babel.config.js，添加插件配置：

module.exports = function(api) {
  api.cache(true);
  return {
    presets: ['babel-preset-expo'],
    plugins: [
      [
        'transform-remove-imports',
        {
          test: /^(fs|os)$/, // 精准匹配要移除的模块
        },
      ],
    ],
  };
};

这个方法的优势是从根源上消除了依赖，打包过程中完全不会处理这些模块，适合导入了但完全没使用的场景。

方法3：修改本地模块的代码（若有权限） #

如果你能修改那个本地开发的模块，可以把依赖fs和os的代码改成条件导入/按需加载，确保只有在Node.js环境下才会加载这些模块：

// 本地模块中的代码示例
let fsModule;
let osModule;

// 仅在Node.js环境下导入核心模块
if (typeof process !== 'undefined' && process.versions.node) {
  fsModule = require('fs');
  osModule = require('os');
}

// 依赖这些模块的函数也要加环境判断
export function nodeOnlyFunction() {
  if (fsModule) {
    // 这段代码永远不会在Expo应用中执行
    fsModule.readFileSync('./some-file.txt');
  }
}

这样Expo打包器扫描模块时，不会执行到导入fs和os的代码段，自然也就不会尝试解析它们了。

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