Vite前端TypeScript项目全局变量声明报错问题排查

问题根源 #

你在globals.d.ts里使用了import语句，导致这个文件被TypeScript判定为模块而非全局声明文件，顶级的declare const game不会作用于全局作用域，因此其他文件无法识别该变量。

解决方案1：用declare global包裹全局声明 #

修改globals.d.ts，将全局变量声明放入declare global块中，即使文件是模块也能让变量作用于全局：

import { Game } from './Game';

declare global {
  const game: Game;
}

export {};

解决方案2：避免触发模块行为 #

如果不想用declare global，可以通过typeof import的方式导入类型，这样文件不会因为导入语句变成模块：

// 通过typeof导入Game类型，避免触发模块判定
type Game = typeof import('./Game').Game;
declare const game: Game;

检查tsconfig.json配置 #

确保globals.d.ts能被TypeScript正确识别：

1. 打开tsconfig.json，确认include数组包含该文件的路径，示例：

{
  "compilerOptions": {
    // 你的其他编译配置项
  },
  "include": [
    "src/**/*.ts",
    "src/globals.d.ts" // 路径根据实际项目结构调整
  ]
}

2. 若配置了typeRoots，需确保它包含声明文件所在目录（默认情况下无需额外配置）。

最后验证 #

修改完成后，重启编辑器的TypeScript语言服务（比如VS Code中按Ctrl+Shift+P执行TypeScript: Restart TS Server），再检查Card.ts里的game变量即可。

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