必须先安装linter(steelbrain作者)作为调度中枢,再装linter-eslint和linter-ui-default;缺linter则linter-eslint无法注册,Settings不可见、命令面板搜不到Linter: Toggle,且.vue/.ts文件需额外配置Lint HTML Files、插件及overrides。

为什么装了linter-eslint却找不到Settings按钮
根本不是插件没装好,而是 Atom 1.24+ 拆分了职责:没有 linter 这个中枢包,linter-eslint 根本注册不进系统。它连“上岗资格”都没有,自然不会出现在设置页里,命令面板也搜不到 Linter: Toggle。
- 必须先装
linter(作者必须是steelbrain),再装linter-eslint;顺序反了或只装后者,等于让工人进厂却不给门禁卡 - 别误装
atom-lint或eslint-atom这类名字相似但作者不同、协议不兼容的包 - 装完任一包后执行
Window: Reload(Ctrl+Alt+R / Cmd+Alt+R),比重启 Atom 快,且能清掉 UI 缓存导致的“已启用但不可见”假象
linter-ui-default装了却没报错提示
这说明检测结果生成了,但没人把它画出来——linter-ui-default 就是那个“医生”,它不运行,Diagnostic 对象就躺在内存里发霉。
-
linter-ui-default不是linter自带的,必须手动apm install linter-ui-default - 装完立刻去 Settings → Packages → 搜索
linter-ui-default,确认右侧开关是蓝色 “Enabled” 状态 - 用了极简主题(如
one-light-ui)时,gutter 图标可能被设为透明;临时切回one-dark-ui排查,别一上来就改配置
Vue/TS 文件完全不触发 ESLint 检查
linter-eslint 默认只认 .js 和 .jsx,对 .vue 或 .ts 是静音的。它需要你明确告诉它:“这些文件里的 script 块也要走 ESLint”。
- 在
linter-eslint设置页勾选Lint HTML Files(Vue 必开) - 项目里装
eslint-plugin-html和eslint-plugin-vue:npm install eslint-plugin-html eslint-plugin-vue --save-dev -
.eslintrc.js中加overrides,显式指定处理器:processor: "vue/vue",否则 ESLint 启动直接报错退出 - TypeScript 需确保
parserOptions.parser指向@typescript-eslint/parser,且plugins包含@typescript-eslint
插件显示“已启用”但快捷键/高亮/面板全失效
大概率是 Node 版本不匹配——Atom 自带独立 Node(当前主流 v12.x/v14.x),不走系统 Node。含原生模块的插件(如 spell-check、term3)必须用 Atom 内置 Node 重编译,否则 require 阶段就失败。
- 关掉所有 Atom 窗口(包括后台进程)
- 运行
apm rebuild—— 它会强制用当前 Atom 内置 Node 重新编译所有包 - 千万别用
npm rebuild,它调的是系统 Node,对 Atom 完全无效 - 若
apm rebuild报zlib错误,说明缓存已损坏,先跑apm clean再重来
关键点不在“谁先装”,而在于“谁负责调度”;很多加载异常本质是链路断裂,不是插件本身坏了。检查控制台(View → Developer → Toggle Developer Tools → Console)里有没有 Failed to activate package 'xxx' 这类报错——那才是真凶线索。











