Angular项目中ESLint no-explicit-any规则下Google Maps类型定义问题

以下几种方案可以解决你遇到的问题，按推荐优先级排序：

• 使用官方TypeScript类型定义（最推荐）
  安装Google Maps的官方类型包，完全避免any类型：

  npm install @types/google.maps --save-dev
  

  安装后无需手动声明google变量，直接在代码中使用google.maps.Map等类型即可，TypeScript会自动识别类型，同时符合ESLint规则。

• 自定义局部类型替代any
  如果不想安装类型包，可针对需要用到的Google Maps属性定义接口，替代any：

  // 定义你实际需要用到的Google Maps属性子集
  interface GoogleMaps {
    maps: {
      Map: new (element: HTMLElement, options: { center: { lat: number; lng: number }; zoom: number }) => void;
      // 按需添加其他需要的属性/方法
    };
  }
  
  declare const google: GoogleMaps;
  

  这样既能通过ESLint校验，又能正常访问所需的google.maps属性。

• 类型断言临时转换unknown（应急方案）
  如果已经声明为unknown，可通过类型断言临时转换为所需类型：

  declare const google: unknown;
  
  // 使用时转换类型
  const map = new ((google as { maps: { Map: new (el: HTMLElement, opts: any) => void } }).maps.Map)(
    document.getElementById('map'),
    { center: { lat: -34.397, lng: 150.644 }, zoom: 8 }
  );
  

  注意这种方式不够严谨，仅适合临时场景。

• 局部禁用ESLint规则（妥协方案）
  若以上方案都不适用，可在声明行单独禁用规则，不影响全局配置：

  // eslint-disable-next-line @typescript-eslint/no-explicit-any
  declare const google: any;
  

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