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 就会静默跳过——它不会报错,也不会提示你缺配置。











