如何为globalThis定义Symbol索引的TypeScript类型定义？

方案1：通过唯一Symbol常量扩展GlobalThis类型 #

1. 在项目的typings/global.d.ts中添加类型声明：

declare const INTERNAL_FAKE_SYMBOL: unique symbol;

interface GlobalThis {
  [INTERNAL_FAKE_SYMBOL]: { loader: boolean };
}

2. 在业务代码中使用该常量替代直接调用Symbol.for：

const INTERNAL_FAKE_SYMBOL = Symbol.for('internal.fake');

globalThis[INTERNAL_FAKE_SYMBOL] = { loader: true };
console.log(globalThis[INTERNAL_FAKE_SYMBOL].loader);

这种方式让TypeScript精准识别该Symbol对应的属性类型，完全避免any断言。

方案2：直接扩展GlobalThis的特定Symbol索引 #

如果不想额外定义常量，可直接在类型声明中指定目标Symbol的类型：

// typings/global.d.ts
interface GlobalThis {
  [Symbol.for('internal.fake')]: { loader: boolean };
}

之后原代码即可正常运行，TypeScript会自动识别该Symbol对应的属性类型，不再抛出7053错误。

配置注意 #

确保tsconfig.json已正确包含类型文件：

{
  "compilerOptions": {
    "strict": true,
    "typeRoots": ["./typings", "./node_modules/@types"]
  },
  "include": ["src/**/*", "typings/**/*"]
}

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