必须先装linter框架（steelbrain作者），再装linter-eslint适配器和linter-ui-default渲染层；缺任一层均无波浪线，Vue文件还需勾选Lint HTML Files、安装eslint-plugin-vue并配置overrides。
装了 linter-eslint 却没报错？不是插件坏了，是 Atom 的三层依赖缺了一环——linter 框架、linter-eslint 适配器、linter-ui-default 渲染层，少一个都看不到波浪线。
必须先装 linter（steelbrain 作者）再装 linter-eslint
Atom 1.24+ 强制拆分架构：linter 是底层事件总线和诊断注册中心，linter-eslint 只是它的一个“语言插件”。没装前者，后者连 Settings 页面都打不开，命令面板搜不到 Linter: Toggle。
- Settings → Install → 搜
linter，确认作者是steelbrain，安装后必须执行Window: Reload（快捷键Ctrl+Alt+R/Cmd+Alt+R） - 再搜
linter-eslint单独安装，别选带-atom后缀或作者不明的同名包 - 验证是否装对：Settings → Packages →
linter-eslint→ Settings 页面能点开，且右下角状态栏显示 “0 problems”（不是空白）
linter-ui-default 不启用，就等于没装
波浪线、悬停提示、底部问题计数，全靠 linter-ui-default 渲染。它不负责分析，只负责“画出来”。很多用户装完前两步却零反馈，就是卡在这一步。
- Settings → Install → 搜
linter-ui-default（作者也必须是steelbrain），安装并启用 - 进 Settings → Packages →
linter-ui-default，确认右侧开关是蓝色Enabled - 避免冲突：禁用
linter-gutter、linter-ui-plus等第三方 UI 插件，它们会压制默认渲染逻辑 - 极简主题可能隐藏 gutter 图标，临时切回
one-dark-ui排查
.vue 文件不检查？关键在 Lint HTML Files + overrides 配置
linter-eslint 默认只处理 .js 和 .jsx，.vue 被当 HTML 解析，里面的 <script> 块根本不会进 ESLint 流程——所以不是“检查失败”，是压根没启动。
前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。前端设计与 UI/UX 全方位优化专家。覆盖视觉层次、排版系统、色彩理论、响应式布局、交互体验、动画动效、无障碍访问、性能优化八大维度，帮助开发者将普通页面升级为高品质产品级界面。
立即学习“前端免费学习笔记（深入）”；
- Settings → Packages →
linter-eslint→ Settings，务必勾选Lint HTML Files - 项目中运行：
npm install eslint-plugin-html eslint-plugin-vue --save-dev -
.eslintrc.js中加overrides显式接管：overrides: [{ files: ["*.vue"], processor: "vue/vue", rules: { "no-unused-vars": "off" } }] - 注意：
processor: "vue/vue"依赖eslint-plugin-vue，没装它，ESLint 启动直接崩溃，不是静默失效
报错位置不准、--fix 失效、no-new 误拦？看版本与作用域
ESLint v8+ 需要 linter-eslint ≥ v9.0.0；而 no-new 报 main.js 是规则真在起作用，不是插件 bug。
- 检查插件版本：Settings → Packages →
linter-eslint→ 查看右上角版本号，低于 v9.0.0 请升级 -
no-new问题：Vue 2 的new Vue({})确实违反该规则。推荐行级禁用：// eslint-disable-next-line no-new放在该行末尾 - 右下角语法识别错误也会导致失效：若显示
Plain Text或Auto，手动点击切换为JavaScript或Vue Component - Mac 用户常见 PATH 问题：GUI 启动的 Atom 可能找不到 nvm/yarn 的
eslint，改用终端执行atom --new-window .启动
最常被跳过的其实是 linter-ui-default 的启用状态和 .vue 的 overrides 中 eslint-plugin-vue 的安装——这两处一漏，整个配置就退化成“看起来装好了，实际什么都没发生”。
