如何在TypeScript中为Symbol新增自定义全局符号属性

你需要通过TypeScript的接口合并能力扩展全局SymbolConstructor的类型定义，操作步骤如下：

1. 新建全局声明文件（比如命名为global.d.ts，放在项目根目录或类型声明文件夹下），写入以下内容：

declare global {
  interface SymbolConstructor {
    // 在这里声明你要新增的自定义属性及对应类型
    hello: symbol;
  }
}
// 该行用于将文件标记为ES模块，避免类型声明报错
export {}

2. 确认你的tsconfig.json的include配置包含了该声明文件，示例配置参考：

{
  "compilerOptions": { /* 你的其他配置 */ },
  "include": ["src/**/*", "global.d.ts"]
}

3. 之后你就可以直接给Symbol挂载自定义属性，使用时也不会再报类型错误：

// 赋值不需要再断言为any
Symbol.hello = Symbol("hello");

// 使用时TypeScript可正常识别类型
console.log(Symbol.hello);

原理解释 #

TypeScript对全局内置对象的类型都是通过接口定义的，Symbol对应的类型是SymbolConstructor接口。接口本身支持合并特性，你新增的同名接口定义会和原有内置定义合并，从而让TypeScript识别到你新增的自定义属性。

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