TypeScript：为全局命名空间中的命名空间声明创建别名

我太懂这种憋屈了——明明编译时用foo.Bar一切正常，结果浏览器一跑就报foo is not defined，根源就是类型定义的结构和库的实际运行时作用域完全对不上！下面给你几个实用的解决思路：

方案1：扩展全局类型，让类型适配运行时 #

不用修改原有的DefinitelyTyped类型文件，我们可以自己加一个类型声明文件来补全全局作用域的类型：

1. 在项目根目录创建一个global-lib-fix.d.ts文件
2. 写入以下内容，直接复用原库的类型定义：

declare global {
  // 把Bar和Baz声明为全局类，复用foo模块里的已有类型
  class Bar extends import('foo').Bar {}
  class Baz extends import('foo').Baz {}

  // 如果库还有全局函数/变量，也可以在这里补充
  // function doGlobalThing(): void;
}

// 必须加这行，让TypeScript把这个文件当作模块处理
export {};

这样一来，你在代码里直接写new Bar()就能获得完整的类型提示，同时运行时也能匹配浏览器全局的Bar对象。

方案2：运行时将foo的导出挂载到全局 #

如果你更倾向于保留原类型的使用方式，同时让运行时能找到对应变量，可以在项目的入口文件（比如main.ts）里添加这段代码：

import * as foo from 'foo';

// 把foo的所有导出内容挂载到浏览器全局window对象上
Object.assign(window, foo);

之后你既可以用foo.Bar（编译正常），也可以直接用Bar（运行正常），不过为了让TypeScript认可全局的Bar，还是需要配合方案1里的类型声明文件。

方案3：修改原类型定义（适合长期维护场景） #

如果你打算长期使用这个库，或者能提交PR到DefinitelyTyped，可以直接调整类型文件的结构：
把原类型里的export namespace foo { ... }改成全局声明+可选的foo导出：

// 先声明全局类，保留原类型的所有属性和方法
declare class Bar {
  constructor(opts: BarOptions);
  someMethod(): void;
}

declare class Baz {
  static version: string;
  doThing(): boolean;
}

// 保留foo的导出，兼容原来的导入方式
declare namespace foo {
  export type Bar = globalThis.Bar;
  export type Baz = globalThis.Baz;
  export const Bar: typeof globalThis.Bar;
  export const Baz: typeof globalThis.Baz;
}

export = foo;

这样不管是用import { Bar } from 'foo'还是直接用全局Bar，类型和运行时都能完美匹配。

小提示 #

• 确保你的自定义类型声明文件被tsconfig.json的include字段包含（比如include: ["src/**/*", "*.d.ts"]）
• 浏览器环境下全局对象是window，如果是Web Worker等特殊环境，要替换成对应的全局对象

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