如何在TypeScript类型中从根作用域引用导出的命名空间？

非导出命名空间的正常引用 #

当命名空间未被export时，可以通过globalThis直接引用外层同名命名空间的成员，避免嵌套内部的命名空间混淆：

namespace A {
    export interface X { inner: string }
}

namespace B {
    namespace A {
        interface Y { inner: globalThis.A.X }
    }
}

这段代码可以正常编译，globalThis.A.X明确指向最外层的A命名空间中的X接口。

导出命名空间的编译报错 #

但如果外层命名空间被export，使用globalThis引用会报错：

export namespace A {
    export interface X { inner: string }
}

namespace B {
    namespace A {
        interface Y { inner: globalThis.A.X }
    }
}

报错信息：

error: Namespace 'globalThis' has no exported member 'A'.

原因是被export的命名空间不会挂载到全局对象globalThis上，因此无法通过这种方式访问。

可行的解决方法 #

1. 模块内重命名导入（适用于模块文件） #

如果当前文件是模块（存在export或import），可以通过导入并重命名外层命名空间来引用：

export namespace A {
    export interface X { inner: string }
}

// 导入外层A并命名为OuterA，避免和B.A冲突
import { A as OuterA } from './当前文件路径';

namespace B {
    namespace A {
        interface Y { inner: OuterA.X }
    }
}

2. 类型专用导入（优化方案） #

如果仅需要引用类型（比如接口），可以使用import type减少运行时影响：

export namespace A {
    export interface X { inner: string }
}

import type { A as OuterA } from './当前文件路径';

namespace B {
    namespace A {
        interface Y { inner: OuterA.X }
    }
}

3. 全局声明兼容（非推荐，适用于特殊场景） #

如果需要保持命名空间导出的同时，让其能被globalThis访问，可以将外层A声明到全局作用域：

declare global {
    namespace A {
        export interface X { inner: string }
    }
}

export namespace A {
    export interface X { inner: string }
}

namespace B {
    namespace A {
        interface Y { inner: globalThis.A.X }
    }
}

这种方式不推荐用于模块化项目，可能会导致全局命名污染。

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