Atom代码检查需三者缺一不可：linter核心（steelbrain作者）、linter-eslint插件、linter-ui-default界面组件；仅装linter-eslint无波浪线，因linter未装则其无法注册，linter-ui-default未装则不渲染提示，且须按序安装并重启窗口。

Atom 本身不带代码错误实时检查能力，必须装 linter 核心包 + 对应语言的检查插件（比如 linter-eslint）+ linter-ui-default，三者缺一不可。只装一个，基本等于没装。

为什么装了 linter-eslint 还没波浪线？

这不是插件坏了，是 Atom 的 lint 架构强制分层：

• linter 是底层事件总线，没它，linter-eslint 根本注册不上，Settings 页面都打不开
• linter-eslint 只负责调 eslint 命令、解析结果，不画红线、不弹提示
• linter-ui-default 才真正渲染波浪线、悬停提示、状态栏计数；禁用它，就只剩控制台里一行日志

验证方法：打开命令面板（Ctrl+Shift+P），搜 Linter: Toggle —— 搜不到说明 linter 没装好；搜得到但没反应，大概率 linter-ui-default 没启用。

安装顺序和关键动作

别信“一键安装”，必须按顺序手动操作：

• 先在 Settings → Install 里搜 linter，认准作者 steelbrain，安装后执行 Window: Reload（快捷键 Ctrl+Alt+R）
• 再搜 linter-eslint 单独安装，别选带 -atom 后缀或作者不明的包
• 最后运行命令行：apm install linter-ui-default，进 Packages 设置页确认开关是蓝色 “Enabled”

装完不重启 Atom 或不重开项目，旧环境变量和语法识别可能卡住，建议关闭所有窗口后重新用 Add Project Folder 打开项目根目录。

常见静默失效场景

波浪线不出现，往往不是插件问题，而是环境没对齐：

• ESLint not found：Atom GUI 启动不继承 shell 的 $PATH，必须在 linter-eslint 设置页手动填 ESLint Path，优先用项目内 ./node_modules/.bin/eslint，全局路径用 which eslint 查
• Vue 文件没检查：linter-eslint 默认只扫 .js 和 .jsx，需勾选 Lint HTML Files，并在 .eslintrc.js 中加 overrides 配置，指定 files: ["*.vue"] 和 processor: "vue/vue"
• 配置文件被忽略：ESLint 只读项目根目录下的 .eslintrc.js 或 package.json 中的 eslintConfig 字段，不认 ~/.eslintrc.js 这类全局配置

最易被忽略的一点：插件装全了，但项目里没有 .eslintrc.js 或 package.json 里没 eslintConfig，ESLint 就会静默跳过——它不会报错，也不会提示你缺配置。