为.commitlintrc.js配置@commitlint/types类型提示无效，求排查

可能的原因分析 #

commitlint的UserConfig类型导出结构和prettier、stylelint略有差异，部分IDE对JS文件中这类嵌套导入的类型推断支持不够友好；另外，commitlint官方对JS配置文件的类型提示支持优先级低于TS配置，导致JSDoc的类型注解未被正确识别。

可行的解决办法 #

1. 调整JSDoc注解写法，显式引入类型模块 #

把类型导入拆分为显式require引入，部分IDE对这种写法的识别度更高：

const { UserConfig } = require('@commitlint/types');

/** @type {UserConfig} */
module.exports = {
  extends: ['@commitlint/config-conventional'],
  // 你的配置内容
};

2. 给IDE添加类型提示配置（以VS Code为例） #

在项目根目录创建jsconfig.json，明确指定类型根目录，帮助IDE识别commitlint的类型定义：

{
  "compilerOptions": {
    "typeRoots": ["./node_modules/@types", "./node_modules/@commitlint/types"]
  },
  "include": [".commitlintrc.js"]
}

3. 用TS兼容写法保留JS文件后缀 #

如果上述方法无效，可在JS文件中添加// @ts-check指令，让IDE以TS规则检查文件，从而正确识别类型注解：

// @ts-check
/** @type {import('@commitlint/types').UserConfig} */
module.exports = {
  extends: ['@commitlint/config-conventional'],
  // 你的配置内容
};

补充说明 #

commitlint官方在类型定义优化上更侧重TS场景，JS配置文件的类型提示支持确实不如TS完善，但通过调整注解写法或IDE配置，基本可以解决代码提示问题。

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