TypeScript编译缺失*.d.ts文件，Angular懒加载外部模块问题咨询

针对你遇到的*.d.ts文件未纳入TypeScript编译错误，结合你的环境（Angular 5.2.9、Angular CLI 1.7.3、TypeScript 2.5.3）和业务场景（懒加载ng-packagr打包的模块），我整理了几个针对性的解决方案：

1. 显式配置tsconfig.json的include属性 #

TypeScript编译器默认只会识别项目src目录下的文件，对于外部打包的懒加载模块的.d.ts文件，需要手动添加到编译范围：

打开根目录下的tsconfig.json，修改include数组，加入懒加载模块的.d.ts文件路径：

{
  "compilerOptions": {
    // 保留你原有的编译配置，比如target、module等
  },
  "include": [
    "src/**/*",
    // 根据你的模块位置调整路径，比如模块在node_modules或自定义libs目录
    "./node_modules/your-lazy-module/**/*.d.ts",
    // 或者如果是本地开发的模块，比如在项目根目录的libs下：
    "./libs/lazy-module/dist/**/*.d.ts"
  ]
}

2. 同步修改tsconfig.app.json的配置 #

Angular CLI在编译时会优先使用src/tsconfig.app.json（如果存在），所以需要确保这个子配置文件也包含了懒加载模块的.d.ts路径：

{
  "extends": "../tsconfig.json",
  "compilerOptions": {
    // 子配置的专属选项
  },
  "include": [
    "src/**/*",
    // 对应根目录的相对路径，比如：
    "../node_modules/your-lazy-module/**/*.d.ts"
  ]
}

3. 确认ng-packagr是否正确生成了声明文件 #

如果你的懒加载模块的.d.ts文件本身就没有生成，那配置再多也没用。检查模块的ng-package.json配置，确保开启了声明文件生成：

{
  "$schema": "./node_modules/ng-packagr/ng-package.schema.json",
  "lib": {
    "entryFile": "src/public_api.ts",
    "declarations": true // *必须设置为true*，才会生成.d.ts文件
  }
}

重新打包模块后，去输出目录（通常是dist）确认是否存在index.d.ts及组件对应的.d.ts文件。

4. 清理编译缓存并重新构建 #

Angular CLI的缓存可能会导致配置变更不生效，执行以下步骤清理缓存：

• 运行Angular CLI的清理命令：

  ng clean
  

• 手动删除缓存目录（Windows系统）：

  rmdir /s /q node_modules\.cache
  

• 或者Mac/Linux系统：

  rm -rf node_modules/.cache
  

• 最后重新构建项目：

  ng build --aot
  

额外注意点 #

• 确保懒加载路由的配置正确：Angular 5中懒加载的写法通常是字符串形式，比如loadChildren: './lazy-module/lazy.module#LazyModule'，不要写错模块路径和类名。
• 路径配置要注意相对位置：如果你的懒加载模块在项目外部，要确保路径是可被TS编译器访问到的绝对或相对路径。

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