React/TypeScript项目部署报错：找不到GlobalFetch，TS版本4.2.3

可能的原因及对应解决方法 #

• TypeScript 库配置缺失
  GlobalFetch 属于 DOM 全局类型的一部分，检查你的 tsconfig.json 中 compilerOptions.lib 是否包含 "dom"。如果部署环境使用了不同的 tsconfig（比如 tsconfig.prod.json），也要确认该配置文件的 lib 字段是否正确。
  示例正确配置：

  {
    "compilerOptions": {
      "lib": ["dom", "es2020"]
    }
  }
  

• 依赖版本不一致
  虽然你本地安装的 TypeScript 是 4.2.3，但部署环境可能存在依赖版本差异：

  • 检查 package-lock.json 或 yarn.lock 是否被提交到仓库，确保部署时安装的依赖和本地完全一致。
  • 确认 @snowpack/plugin-typescript 的版本在两台机器上是否相同，部分旧版本插件可能对 TypeScript 4.x 的全局类型处理有兼容问题。

• 全局类型依赖未安装
  若部署环境未安装 DOM 相关的类型定义包，可能导致 TypeScript 无法识别 GlobalFetch。确保 @types/web 或 @types/dom 已添加到 devDependencies，并在部署时完整安装所有依赖（避免使用仅生产依赖的安装命令）。

• 缓存残留问题
  部署环境的 Snowpack 或 TypeScript 缓存可能残留了旧的类型信息，执行以下命令清理缓存后重新构建：

  snowpack clean
  rm -rf node_modules/.cache
  

• Node.js 环境差异
  不同 Node.js 版本可能影响 TypeScript 对全局类型的解析逻辑，确认部署环境的 Node.js 版本与本地一致（可通过 node -v 查看）。

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