必须按linter框架→linter-eslint语言适配器→linter-ui-default ui层三级顺序安装启用；缺任一层均导致零提示，vue文件还需勾选lint html files、装eslint-plugin-html/vu及配置overrides。
Atom 的代码检测不是装个插件就自动生效的，必须按框架层 → 语言层 → UI 层三级顺序安装，漏掉任意一层都会“零提示”。核心问题从来不是插件没找到，而是 linter 框架没装，或 linter-ui-default 没启用。
为什么装了 linter-eslint 却完全不报错？
根本原因：Atom 1.24+ 强制拆分架构，linter 是必须先装的基础框架，linter-eslint 只是它的一个“插件适配器”。没装前者，后者连注册机会都没有。
- 打开 Atom → Settings → Install，搜
linter（作者必须是steelbrain），安装并重启 - 再搜
linter-eslint单独安装，别选带-atom后缀或作者不明的同名包 - 装完执行
Window: Reload（快捷键Cmd+Alt+R/Ctrl+Alt+R），否则缓存不刷新，配置不热更 - 检查
Settings → Packages → linter-eslint → Settings页面是否可点——点不开就说明框架没装对
错误提示不显示、标红失效、底部状态栏写 “0 problems”？
这是 linter-ui-default 缺失或被禁用的典型表现。它负责把诊断结果画出来，而 linter 和 linter-eslint 都不带界面。
- 在 Atom 中搜
linter-ui-default（作者也是steelbrain）并安装 - 进
Settings → Packages → linter-ui-default，确认右侧开关是蓝色 “Enabled” 状态 - 避免装冲突 UI 插件，比如
linter-ui-plus或旧版linter-gutter，它们会压制默认 UI - 极简主题可能隐藏 gutter 图标，临时切回
one-dark-ui+one-dark-syntax排查
Vue 文件里的 JS 不被检查，或只报空错误？
因为 linter-eslint 默认只处理 .js 和 .jsx，.vue 被当 HTML 解析，JS 块根本不会进 ESLint 流程。
- 在
linter-eslint设置页勾选Lint HTML Files - 项目中运行
npm install eslint-plugin-html eslint-plugin-vue --save-dev -
.eslintrc.js中必须加overrides显式接管.vue文件：
overrides: [{
files: ["*.vue"],
processor: "vue/vue",
rules: {
"no-unused-vars": "off"
}
}]
注意：processor: "vue/vue" 依赖 eslint-plugin-vue，没装它，ESLint 启动直接崩溃，不是“没效果”，是压根起不来。
ESLint 配置路径、环境、规则全对，但错误位置不准或不修复？
常见于 ESLint 版本与 linter-eslint 插件不兼容，或 --fix 能力被限制。
- 确认
linter-eslint插件版本 ≥ v9.0.0（ESLint v8+ 必需） - 设置页中填对
ESLint Path：优先指向项目本地node_modules/.bin/eslint，而非全局eslint命令 - 开启
Fix on save时，务必同时勾选Fixable Rules Only，否则非可修复规则会阻断整个流程 -
.eslintignore、/* eslint-disable */注释、或文件被overrides漏掉，都会导致“有错不报”
最容易被忽略的是 Atom 的 Node 环境和终端不一致——Mac 用户尤其要注意 GUI 启动 Atom 时 PATH 常被截断，建议一律用 atom --new-window 从终端启动，继承完整环境。
