如何用跨运行时/Worker兼容的Fetch依赖替换node-fetch？适配Node开发与部署

1. 用package.json的可选依赖+环境变量控制 #

• 将node-fetch添加到optionalDependencies，这样部署到Cloudflare Worker时不会强制安装该包：

{
  "optionalDependencies": {
    "node-fetch": "^3.3.2"
  }
}

• 开发阶段启动服务时设置NODE_ENV=development，Node环境会自动加载可选依赖里的node-fetch，依赖包就能检测到并使用它；生产构建时Worker环境不会安装这个包，依赖包自动回退到全局fetch。

2. ESBuild构建配置（Cloudflare Worker常用） #

ESBuild可以直接排除指定模块，同时模拟浏览器环境触发依赖包的回退逻辑：

// esbuild.config.js
require('esbuild').build({
  entryPoints: ['src/index.js'],
  bundle: true,
  outfile: 'dist/worker.js',
  platform: 'browser', // 让依赖包认为当前是浏览器环境，优先用全局fetch
  external: ['node-fetch'], // 构建时不打包node-fetch
  define: {
    'process.env.NODE_ENV': '"production"'
  }
}).catch(() => process.exit(1))

3. Webpack构建配置 #

如果用Webpack，通过别名和外部依赖配置实现按需排除：

// webpack.config.js
module.exports = {
  // 其他配置项...
  resolve: {
    alias: {
      // 生产环境下把node-fetch指向空模块，避免打包
      ...(process.env.NODE_ENV === 'production' ? { 'node-fetch': false } : {})
    }
  },
  externals: {
    // 生产环境标记node-fetch为外部依赖，不打包进产物
    ...(process.env.NODE_ENV === 'production' ? { 'node-fetch': 'commonjs node-fetch' } : {})
  }
}

4. 修改依赖包检测逻辑（若有权限） #

如果能修改依赖包的代码，直接加环境判断更直接：

// 依赖包中的fetch检测代码
let fetchImplementation;
if (process.env.NODE_ENV === 'development' && !globalThis.fetch) {
  fetchImplementation = require('node-fetch');
} else {
  fetchImplementation = globalThis.fetch;
}

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