如何全局忽略仅在JSDoc参数类型中使用的导入的ESLint报错

ESLint 原生的no-unused-vars规则仅检测代码执行逻辑中的变量引用，不会识别JSDoc注释块中@param、@returns这类标签里的类型标注引用。你导入的ImAClass仅被用在JSDoc类型声明里，没有在实际业务逻辑中调用，就会被误判为未使用变量。

额外提醒：示例代码里的参数名class是ECMAScript保留关键字，直接作为参数名会抛语法错误，建议改成cls、targetClass这类合法标识符。

按改造成本从低到高排序，任选一种即可，不需要到处加eslint-disable注释。

方法1：直接用JSDoc原生动态导入类型（零依赖、零配置，最推荐） #

根本不需要在代码顶部单独声明类型引用的变量，直接在JSDoc类型位置用import()语法引入类型即可，编辑器、TS类型检查都能正常识别，也不会产生多余的变量声明触发lint规则：

/**
* Gets the class
* @param {import("../models/ImAClass.model.js")} cls
* @returns {import("../models/ImAClass.model.js")} Returns the class
*/
function getClass(cls) { 
    return cls;
}

如果同一个类型在同文件里多次用到，还可以用@typedef提前声明一次，不用重复写长路径：

/**
* @typedef {import("../models/ImAClass.model.js")} ImAClass
*/

/**
* Gets the class
* @param {ImAClass} cls
* @returns {ImAClass} Returns the class
*/
function getClass(cls) { 
    return cls;
}

方法2：替换规则为支持JSDoc识别的版本 #

如果不想改现有JSDoc的写法，可以根据项目技术栈替换lint规则：

• 若项目接入了TypeScript做类型检查：直接禁用原生no-unused-vars规则，启用@typescript-eslint/no-unused-vars。该规则默认会把JSDoc里的类型引用算作有效使用，不会产生这类误报。
• 若为纯JS项目：安装eslint-plugin-jsdoc插件，在ESLint配置中声明插件后，启用jsdoc/no-unused-vars规则替代原生规则即可。插件会自动扫描JSDoc中的所有类型引用，将对应导入的变量标记为已使用状态。

方法3：配置规则忽略特定模式的导入 #

如果不想装依赖也不想改现有代码写法，可以在ESLint配置中调整no-unused-vars的varsIgnorePattern参数，让规则忽略团队约定好的、仅用作类型声明的变量，比如约定仅做类型用的类名统一加Type后缀，配置示例：

// .eslintrc.js 配置片段
module.exports = {
  rules: {
    "no-unused-vars": ["error", {
      varsIgnorePattern: "^[A-Z].*Type$" // 匹配大驼峰开头、Type结尾的变量，判定为已使用
    }]
  }
}

这个方法灵活度最低，需要全团队遵守统一命名规范，适合有明确编码约定的项目使用。

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