Angular 11中忽略外部模块严格模式编译报错的实现方法

核心目标：完全保留项目自身代码的strict、noImplicitReturns等严格校验规则，仅对@geoman-io/leaflet-geoman-free这个第三方库跳过类型校验，不影响本地业务代码的检查逻辑。

1. 为第三方库建立专属模块声明，跳过库内部的类型推导 #

因为leaflet-geoman本身没有附带符合Angular严格模式要求的类型声明文件，直接引入时TS会深入解析库源码，触发隐式any、缺返回注解的报错。

• 在项目src目录下新建专属类型声明文件，比如src/types/leaflet-geoman.d.ts
• 在文件中对该第三方模块做宽松声明，内容如下：

  // 声明leaflet-geoman模块，跳过对其内部实现的类型检查
  declare module '@geoman-io/leaflet-geoman-free' {
    // 直接指定模块导出为any，不再触发对库内部参数、方法返回值的严格校验
    const geoman: any;
    export default geoman;
  }
  

  这个声明的作用是：TS在解析到对该库的import语句时，直接读取我们自定义的类型声明，不会再反向去解析node_modules里该库的源码做类型推导，从根源上避免库内部的隐式any类报错。

2. 开启TS编译层面的库校验跳过配置 #

在项目根目录的tsconfig.json的compilerOptions配置块中，新增skipLibCheck配置：

{
  "compilerOptions": {
    // 保留原有的所有严格配置不变
    "strict": true,
    "noImplicitReturns": true,
    // 新增：跳过node_modules下所有库的声明文件校验
    "skipLibCheck": true
  }
}

skipLibCheck的作用范围仅覆盖node_modules路径下的库文件，完全不会影响本地业务代码的严格校验逻辑——因为本地业务代码不在node_modules路径内，所有strict规则、noImplicitReturns规则对本地代码的约束和之前完全一致。
如果配置之后仍然有残留的该库相关报错，可以在tsconfig的exclude数组中显式添加该库的源码路径，进一步将其从独立编译入口中剥离：

{
  "exclude": [
    "node_modules/@geoman-io/leaflet-geoman-free/**/*"
  ]
}

3. 常见避坑提醒 #

• 不要为了消错直接全局关闭noImplicitAny、noImplicitReturns配置，会直接丢失本地业务代码的严格类型校验能力，违背最初的配置目标。
• 不要直接修改node_modules目录下的库源码来消错，每次执行依赖安装时修改的内容会被直接覆盖，没有长期维护价值。
• 如果后续使用该库的特定方法需要类型提示，可以在之前创建的专属.d.ts文件中，针对实际用到的方法手动补充类型注解，不需要引入库本身的内置声明文件，就不会触发严格模式报错。

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