Angular8+TS3.4.5自定义Window类型仍报错，求解决方案

问题重现 #

执行ng server时出现TS2339编译错误，提示Window对象不存在API、FooServices、__Zone_disable_requestAnimationFrame等自定义属性；同时IntelliJ IDEA也在使用这些属性的文件中提示类型错误，尽管已编写global.d.ts并配置typeRoots。

排查与解决步骤 #

1. 确认global.d.ts的位置与路径配置 #

• 确保global.d.ts文件严格放在typeRoots指定的路径下：你配置的路径是projects/shared/src/lib/types，该文件必须位于这个目录中，TypeScript只会加载typeRoots目录下的类型定义文件。
• 检查路径拼写是否正确（如大小写、目录层级），避免相对路径错误。

2. 检查应用级tsconfig配置 #

Angular项目通常存在多个tsconfig文件（如根目录tsconfig.json、tsconfig.app.json），需确保自定义类型配置在应用实际使用的tsconfig中生效：

• 打开tsconfig.app.json，确认它是否继承了根目录tsconfig的typeRoots配置，或者直接在tsconfig.app.json的compilerOptions中添加相同的typeRoots配置。

3. 处理parent对象的类型扩展 #

错误中出现parent.FooServices，parent默认属于Window类型，但需确保自定义的Window扩展覆盖parent的类型：
在global.d.ts的Window接口中显式声明parent属性：

declare global {
  interface Window {
    parent: Window;
    // 其他已定义属性
    FooServices: any;
    API: any;
    __Zone_disable_requestAnimationFrame: any;
  }
}
export {};

4. 清除IntelliJ IDEA缓存 #

IDE缓存可能导致旧类型信息未更新：

• 点击菜单栏File → Invalidate Caches...
• 选择Invalidate and Restart，重启IDE后重新检查错误。

5. 验证TypeScript模块声明正确性 #

确保global.d.ts的模块声明格式正确：

• 必须保留export {}语句，将文件标记为ES模块，否则declare global不会生效。你当前的写法是正确的，请勿删除该语句。

6. 排查类型冲突 #

• 检查是否有其他.d.ts文件也扩展了Window接口，导致自定义属性被覆盖。可暂时移除其他可能冲突的类型文件，测试是否生效。
• 确认typeRoots中自定义路径放在node_modules/@types之前（你已配置），保证自定义类型优先级高于默认类型。

临时 workaround（紧急场景用） #

如果以上步骤仍未解决，可在使用全局属性时显式断言类型，规避编译错误：

// 示例：使用window.API
{ provide: API, useValue: (window as any).API },
// 示例：使用parent.FooServices
(parent as any).FooServices.Component = (): { subscribe: () => void } => { /* 业务逻辑 */ };

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