装了linter-eslint却没红线,首要检查三件事:必须先装linter(steelbrain作者),再装linter-eslint;装完执行window: reload刷新缓存;取消勾选“disable when no eslint config is found”,并确保.eslintrc.js在项目根目录且含root: true。

装了 linter-eslint 却没红线?先看这三件事
不是插件坏了,是 Atom 的 ESLint 集成有硬性依赖链:缺一不可。常见静默失效,基本都卡在这三点。
- 必须先装
linter(作者 steelbrain),再装linter-eslint——前者是 UI 框架,后者只是“语言适配器”,没前者,后者根本注册不上 - 装完必须执行
Window: Reload(快捷键Ctrl+Alt+R/Cmd+Alt+R),否则配置缓存不刷新,插件形同虚设 -
linter-eslint设置页里,“Disable when no ESLint config is found” 必须取消勾选;否则项目根目录没有.eslintrc.js或package.json里没eslintConfig字段,插件直接退出,连日志都不打
.eslintrc.js 必须在项目根目录且含 root: true
ESLint 默认只读取项目根目录下的配置文件,完全不认全局配置(比如 ~/.eslintrc.js)。路径错或配置缺失,就等于没配。
- 推荐用
npx eslint --init在项目根目录生成.eslintrc.js,它会自动加root: true—— 这行不能少,否则 ESLint 可能向上遍历父目录找配置,导致规则冲突或意外禁用 - Mac 用户注意:
atom若双击图标启动,常因 GUI 环境缺失 Node PATH,找不到本地或全局的eslintCLI;改用终端执行atom --new-window启动,才能继承 shell 环境 - 如果用全局 ESLint(
npm install -g eslint),必须在linter-eslint设置里勾上 “Use global ESLint installation”;否则插件默认去node_modules/.bin/eslint找,找不到就罢工
Vue 文件里的 JS 不报错?光勾 Lint HTML Files 不够
即使开了 “Lint HTML Files”,.vue 文件里的 JS 仍可能被错当成普通 HTML 字符串解析,规则不触发或报错错乱。
你接手一个需求时,是不是经常这样:"改一个小字段 → 结果把不相关的代码也改了"、"需求说得很模糊 → 做着做着发现跑偏了"、"数据库加个字段 → 上线才发现漏了数据兼容"、"做了个新功能 → 一个月后自己都忘了当时怎么设计的"、"写到一半被中断 → 再回来不知道从哪继续";这个 Skill 就是专门解决这些问题的。 它会自动探测你的项目环境(JDK、Spring Boot、ORM、数据库、前端框架),记在
- 必须安装
eslint-plugin-html:npm install eslint-plugin-html --save-dev - 在
.eslintrc.js中加overrides,显式把.vue文件交给 HTML 处理器:
overrides: [
{
files: ["*.vue"],
processor: "html/vue"
}
]
- 确保已安装
eslint-plugin-vue(如需 Vue 特定规则),并在plugins和extends中正确引用
Fix on save 失效?检查这四个开关是否全开
自动修复不是装了就生效,它是一组条件共同作用的结果。
-
linter-eslint设置里:“Fix on save” 和 “Fixable Rules Only” 必须同时开启 - 当前文件不能被
.eslintignore排除,也不能写/* eslint-disable */注释 - 如果同时用了
prettier-atom,建议关掉linter-eslint的自动修复——两者对缩进、引号、逗号反复修改,容易互相覆盖、格式错乱 - 规则本身得是可修复的(比如
semi、quotes),像no-console这类纯提示型规则不会被自动 fix
真正卡住人的地方,往往不是规则怎么写,而是 Atom 启动方式、配置文件位置、插件依赖顺序这些“看不见”的链路。漏掉任意一环,ESLint 就彻底静默——它不报错,也不提醒你哪里错了。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










