global.d.ts中定义的Window自定义属性dataLayer不存在问题排查

• 确保global.d.ts的类型定义写法正确
  必须使用declare global块扩展Window接口，并且文件要作为模块（添加export {}），示例：

  declare global {
    interface Window {
      // 根据你的dataLayer实际类型替换，比如数组或对象
      dataLayer: Array<Record<string, unknown>>;
    }
  }
  
  export {}; // 关键：让文件成为模块，触发全局接口合并
  

  如果省略export {}，TS会将该文件视为全局脚本，declare global不会生效，无法正确合并Window接口。

• 检查tsconfig.json的compilerOptions配置

  • 避免设置types: []，这会禁用自动加载所有@types包和全局类型文件；若必须设置types，需手动添加必要类型（如"types": ["node"]），同时确保自定义.d.ts在include范围内。
  • 确认typeRoots未排除自定义类型文件所在目录，默认typeRoots包含node_modules/@types，若自定义类型在src/types下，需添加"typeRoots": ["node_modules/@types", "src/types"]。

• 排查类型冲突或重复定义
  检查项目中其他.d.ts文件是否有重复的Window接口定义，或者第三方库的类型文件是否覆盖了Window接口，导致自定义的dataLayer属性被忽略。

• 重启TypeScript语言服务
  即使tsc编译时识别了global.d.ts，编辑器的TypeScript服务可能缓存了旧类型，重启服务（VSCode中按Ctrl+Shift+P选择"TypeScript: Restart TS Server"）可解决实时检查的错误。

• 确认exclude配置未排除global.d.ts
  检查tsconfig.json的exclude字段，确保没有将global.d.ts所在目录排除，比如若exclude包含"**/*.d.ts"会直接忽略所有类型定义文件，导致配置失效。

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