为什么TypeScript中global的类型定义为typeof globalThis？

我们在不同运行环境中会访问不同的全局对象：

• window - 浏览器环境
• global - Node.js环境
• globalThis - 所有环境

但TypeScript却把Node.js的global类型定义为typeof globalThis，导致编写global.localStorage这类在Node.js运行时根本不存在的代码时，不会触发TypeScript错误。这种设计的原因主要有以下几点：

1. 对齐ES标准的全局类型体系 #

globalThis是ES官方定义的统一全局对象，TypeScript作为ES的超集，核心目标之一是对齐ES标准。将global和window的类型都统一到globalThis上，能让全局API的类型在不同环境下保持一致，比如console、setTimeout这类跨环境存在的API，不用再维护多套重复的类型定义。

2. 兼容跨环境代码与扩展场景 #

很多开发者会写跨环境运行的代码，或者在Node.js环境中使用模拟浏览器的工具（如jsdom），这些场景下global上会挂载浏览器特有的API（比如localStorage）。用globalThis的类型定义可以覆盖这类扩展场景，避免开发者在做环境模拟时还要手动修改全局类型。

3. 避免类型分裂带来的维护成本 #

如果给global单独定义一套和globalThis完全割裂的类型，会导致同一个全局API在global和globalThis上出现类型不一致的情况，反而增加类型维护的复杂度，也会让跨环境代码的类型检查变得繁琐。

4. 类型检查的灵活性设计 #

TypeScript的类型系统是渐进式的，它的核心是提供类型提示而非强制限制运行时行为。如果你需要严格的Node.js环境类型检查，可以通过修改tsconfig.json的配置（比如指定lib为["ESNext"]这类不含DOM的选项），或者通过类型断言、自定义类型缩小来限制global的可用属性。

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