导入JS类到TS文件触发ESLint any类型调用错误排查

问题场景 #

我在ChargerPlan.js文件中定义了如下类：

export default class ChargerPlan {
  constructor(...) {
    ...
  }

  /**
   * Creates a ChargerPlan object from a session.
   *
   * @param {ChargeSession} session - The charge session object.
   * @returns {ChargerPlan|null} - The created ChargerPlan object if all required properties are available,
   * null otherwise.
   */
  static createFromSession(session) {
    try {
      ...
      return new ChargerPlan(params);
    } catch {
      return null;
    }
  }
}

在TypeScript文件中导入并调用静态方法：

import ChargerPlanClass from '#src/services/classes/ChargerPlan.js';

const plan = ChargerPlanClass.createFromSession(this);

此时WebStorm内的ESLint报错ESLint: Unsafe call of an any typed value.(@typescript-eslint/no-unsafe-call)，但命令行执行ESLint无任何报错。

可能的原因及解决办法 #

• JSDoc类型依赖未定义
  TypeScript解析JS文件的类型时完全依赖JSDoc注释。你的createFromSession方法参数标注了ChargeSession类型，但如果这个类型没有通过JSDoc（如@typedef）或TS类型文件（.d.ts）明确声明，TypeScript会将其视为any，进而导致整个ChargerPlanClass被推断为any类型，触发@typescript-eslint/no-unsafe-call规则。
  解决：给ChargeSession添加明确的类型声明，示例：

  /**
   * @typedef {Object} ChargeSession
   * @property {string} sessionId - 充电会话ID
   * @property {number} startTimestamp - 会话开始时间戳
   * // 补充其他必要属性定义
   */
  

• WebStorm的ESLint缓存或配置差异
  WebStorm可能缓存了旧的类型推断结果，或者其使用的ESLint配置与命令行不一致（比如加载了不同的.eslintrc文件，或者使用了独立的ESLint实例）。
  解决：

  1. 清除WebStorm缓存：点击File > Invalidate Caches...，勾选Clear file system cache and local history后选择Invalidate and Restart。
  2. 检查ESLint配置：进入Settings > Languages & Frameworks > JavaScript > Code Quality Tools > ESLint，确保选择Automatic ESLint configuration，或者手动指定与命令行一致的配置文件路径。

• TypeScript对JS模块的导出推断缺陷
  部分情况下，TypeScript无法正确解析JS模块的导出类型，即使有JSDoc注释。可以通过强化JSDoc或类型断言来修复。
  解决：
  方式一：在JS类前添加明确的类JSDoc：

  /**
   * @class ChargerPlan
   */
  export default class ChargerPlan {
    // ... 类内容
  }
  

  方式二：在TS导入时使用类型断言：

  import ChargerPlanClass from '#src/services/classes/ChargerPlan.js';
  
  const plan = (ChargerPlanClass as typeof import('#src/services/classes/ChargerPlan.js').default).createFromSession(this);
  

内容的提问来源于stack exchange，提问作者Romulus Urakagi Ts'ai