必须先安装linter核心包(作者steelbrain),再装linter-eslint并执行Window: Reload;Vue文件需勾选Lint HTML Files、安装eslint-plugin-html/vue、配置overrides指定processor,且.eslintrc.js须位于项目根目录并设root: true。

装了 linter-eslint 却没任何红线?不是插件坏了,是 Atom 的 ESLint 集成有明确依赖链和路径要求,漏掉一环就彻底静默。
必须先装 linter 核心包,再装 linter-eslint
Atom 1.24+ 版本起强制拆分架构:linter 是底层事件监听与 UI 渲染框架,linter-eslint 只是它的一个“语言适配器”。不装前者,后者根本注册不上,设置页都可能不显示。
- 在 Atom Settings → Install 里搜
linter(作者 steelbrain),安装并重启 - 再搜
linter-eslint单独安装,别指望“一键全包” - 装完必须执行 Window: Reload(快捷键
Ctrl+Alt+R/Cmd+Alt+R),否则配置缓存不刷新,插件形同虚设
linter-eslint 设置里两个开关决定是否“看得见错误”
进 Settings → Packages → linter-eslint → Settings,以下两项直接影响报错是否触发:
- 勾选
Lint HTML Files:Vue 单文件组件(.vue)里的<script>块默认被当 HTML 处理,不开这个,JS 规则压根不跑 - 取消勾选
Disable when no ESLint config is found:否则项目根目录没.eslintrc.js或package.json里没eslintConfig字段,插件直接静默退出,连错误日志都不打 - 若用全局 ESLint(
npm install -g eslint),必须勾上Use global ESLint installation;否则插件默认去项目node_modules/.bin/eslint找,找不到就罢工
.eslintrc.js 必须存在且路径正确,Mac 用户尤其注意环境变量
linter-eslint 默认只读项目根目录下的 .eslintrc.js、.eslintrc.json 或 package.json 中的 eslintConfig 字段,完全不认全局配置(比如 ~/.eslintrc.js)。
审查 Vue 管理后台的变更请求(Vue 2 + Element UI,Vue 3 + Element Plus)。重点关注最小化变更实现、上线风险检查以及回归检查清单生成。
立即学习“Java免费学习笔记(深入)”;
- 推荐用
npx eslint --init在项目根目录生成配置,避免手写遗漏root: true—— 没这行,ESLint 可能向上遍历父目录找配置,导致规则冲突或意外禁用 - Mac 用户常因双击图标启动 Atom 导致 Node 环境缺失
PATH:改用终端执行atom --new-window启动,才能继承 shell 环境,让eslintCLI 可被找到 - 如果项目用 TypeScript + JSX 混合文件(如
.tsx),prettier-atom默认 parser 会失败 —— 必须在项目根目录.prettierrc里显式加"parser": "typescript",否则整文件跳过格式化
Vue 文件校验失效?多半是解析器和插件没配齐
即使开了 Lint HTML Files,.vue 文件里的 JS 仍可能被错当成普通 HTML 字符串解析,导致规则不触发或报错错乱。
- 确保已安装
eslint-plugin-html:npm install eslint-plugin-html --save-dev - 在
.eslintrc.js中加overrides,把.vue文件交给正确处理器:overrides: [{ files: ["*.vue"], processor: "vue/vue", rules: { "no-unused-vars": "off" } }] -
processor: "vue/vue"依赖eslint-plugin-vue,没装它,这条配置会让 ESLint 启动失败 -
main.js报no-new不是 bug:Vue 2 的new Vue({})被规则拦截是正常行为。只应在该行加// eslint-disable-next-line no-new,别全局关规则
最容易被忽略的是:所有插件装完后必须重启 Atom,且 linter-eslint 的配置变更(比如开关勾选)必须配合 Window: Reload 才生效 —— 缓存不刷,一切白配。

















