TypeScript使用declare global扩展Express Request不被识别问题

• 核心触发条件：declare global 仅在模块文件（文件内存在至少一个 import/export 语句）中生效，作用是将声明合并到全局作用域。
  你的 ./@types/express/index.d.ts 没有任何导入导出语句，本身属于全局声明文件，此时包裹 declare global 相当于在全局作用域下额外声明了一个独立的 globalThis.Express 命名空间，和 @types/express 内置的全局 Express 命名空间完全隔离，无法触发接口合并，因此扩展的属性不会出现在类型补全中。
• 第二种写法生效逻辑：全局声明文件中直接声明 declare namespace Express 时，TypeScript 会自动将该命名空间与已存在的全局 Express 命名空间做合并，你扩展的 Request 接口属性会被正确注入原有类型定义中。

标准写法兼容方案 #

如果需要使用通用的 declare global 写法，只需要在声明文件末尾添加一行 export {}，将文件标记为模块即可正常生效，示例如下：

declare global {
  namespace Express {
    interface Request {
      testProp: { testProp: string };
    }
  }
}
// 新增此行将文件转为模块类型
export {}

场景补充说明 #

各类技术资料推荐的 declare global 写法默认适用场景是在业务代码的 .ts 模块文件中做类型扩展，这类文件本身自带导入导出语句，必须通过 declare global 才能将类型扩展到全局作用域。你将扩展写在独立的全局声明文件中，场景差异导致了“标准写法失效”的错觉，你的 tsconfig.json 中 typeRoots 配置本身没有问题。

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