应关闭默认General检查、正确绑定混合文件类型、自定义TODO高亮、配置ESLint而非依赖IDEA内置检查,并注意配置作用域。

默认的高亮和检查规则几乎一定会干扰你的实际开发节奏——不是代码有问题,是 IDEA 在用别人的规范评判你的项目。
关闭泛滥的 General 检查项
大量黄色波浪线(如 Unused symbol、Variable is never used)通常来自 General 类检查,它们对老项目或脚手架代码毫无意义,纯属视觉污染。
- 路径:
File → Settings → Editor → Inspections,搜索General - 直接取消勾选整个
General分组(不建议逐条关,容易漏) - 保留
Java → Declaration redundancy等真正影响可维护性的子项即可 - 注意:该设置作用于当前项目,若需全局生效,点右下角
Manage profiles → Copy to Project旁的齿轮图标,选Default
让 .java.vm 或 .ft 文件正确高亮
这类混合文件(Java + Velocity/FreeMarker)常被 IDEA 当作纯文本,导致语法失效。关键不在装插件,而在文件类型绑定是否准确。
- 先确认插件已启用:
File → Settings → Plugins中搜Velocity或FreeMarker,勾选并重启 - 再手动绑定后缀:
Editor → File Types→ 找到Velocity或FreeMarker Template→ 点击右侧+添加*.java.vm或*.ft - 如果仍无高亮,检查是否被其他类型抢占:在
Recognized File Types列表中,Text或Auto-detect类型的匹配模式(如*)优先级高于你刚加的规则,需删掉或调低顺序
自定义 TODO/FIXME 高亮颜色
默认的浅灰注释很难快速定位,但 IDEA 的 TODO 工具只识别注释内容,不依赖语言本身——所以 Java、TS、Vue SFC 里都能用。
使用3×3×10框架生成90+个个性化Instagram内容创意,用AI编辑器精选最佳创意,并将获胜者扩展为可操作的简洁内容。
- 路径:
Editor → TODO→ 点+添加新规则 - Pattern 填
FIXME,Description 写“需紧急修复”,Color 设为红色背景+白色字 - 更灵活的写法:
TODO|FIXME|HACK(正则模式),匹配所有三种标记 - 注意:该设置只影响编辑器内高亮,不影响编译或 lint;若想在 ESLint 中也报错,需额外配
@typescript-eslint/no-commented-out-code等规则
TS/JS 项目必须配 ESLint,别信内置检查
IDEA 自带的 TypeScript 检查(如 Unused label)覆盖极窄,且无法对接团队规则。ESLint 才是事实标准,尤其当你用 typescript-eslint 时。
- 先装依赖:
npm install --save-dev eslint @eslint/js typescript typescript-eslint - 根目录建
eslint.config.js,内容至少包含:tseslint.configs.recommended - 在
Settings → Languages & Frameworks → JavaScript → Code Quality Tools → ESLint中启用,并设Automatic configuration - 常见坑:
package.json里的eslintConfig字段已被弃用,IDEA 2025.3+ 不再读取;必须用eslint.config.*新格式
最易忽略的一点:文件类型绑定和 ESLint 配置都分「项目级」和「全局级」,但 Inspections 默认只作用于当前项目。跨项目复用配置时,别只导出 Color Scheme,漏掉 Inspections profile 和 File Types 绑定。否则换个项目,花脸照旧。










