atom linter不报错90%因核心链断裂：必须先装linter（steelbrain作者），再装linter-eslint和linter-ui-default，三者缺一不可；顺序错误、未启用或路径配置不当均导致静默失效。

Atom 里 linter 插件不报错，90% 是因为核心链断在了 linter、linter-ui-default、语言 provider（如 linter-eslint）三者中某一个没装或没启用。

为什么装了 linter-eslint 却完全没反应？

根本不是插件“坏了”，而是 Atom 1.24+ 强制拆分了职责：linter 是调度中枢，linter-eslint 只是干活的“工人”，没中枢它连注册都失败。常见表现包括：设置页里找不到 linter-eslint 的 Settings 按钮、命令面板搜不到 Linter: Toggle、保存后零提示。

• 必须先装 linter（作者 steelbrain），再单独装 linter-eslint ——顺序不能反，也不能只装后者
• 装完任一包都建议执行 Window: Reload（Ctrl+Alt+R / Cmd+Alt+R），不用重启整个 Atom，但 UI 缓存不清会导致界面不更新
• 检查 linter 包是否启用：Settings → Packages → 搜索 linter → 确认开关是蓝色 “Enabled”
• 别误装名字相似但作者非 steelbrain 的包（比如 atom-lint 或带 -atom 后缀的），它们不兼容当前框架

报错不显示、行号标错、底部显示 “0 problems” 怎么办？

这说明错误检测结果传到了编辑器，但渲染层出了问题——linter-ui-default 就是干这个的，它不装或禁用，就等于有诊断报告但没医生读给你听。

蛙蛙写作——超级AI智能写作助手

一款AI视频创作工具，主要用于蛙蛙写作辅助AI写文，帮助获取创意灵感，提供拆书、小说转剧本、视频生成等功能，是一款功能全面的AI智能写作工具，适合需要提升相关任务效率的用户。

下载

• linter-ui-default 必须手动安装（apm install linter-ui-default），它不是 linter 自带的
• 装完立刻去 Settings → Packages → 搜索 linter-ui-default → 确保右侧开关为启用状态
• 如果用了极简主题（比如 one-light-ui），可能把 gutter 图标设为透明；临时切回 one-dark-ui + one-dark-syntax 排查
• 错误位置偏移半行？优先看底部 linter panel 的精确行号——minimap 上的红点是按比例映射的，对 emoji、中文混排长行或折行不校准

Vue / TypeScript 文件不报错，或只报 HTML 错误？

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

ESLint 路径、Node 环境、规则不生效的硬坑

报错逻辑在 provider（如 linter-eslint）里，它调用的是真实 ESLint 进程。路径错、环境错、配置错，都会导致“检测到语法错误但不标红”或“修复不触发”。

• linter-eslint 设置页中 ESLint Path 必须填项目本地路径：./node_modules/.bin/eslint（Mac/Linux）或 .\node_modules\.bin\eslint.cmd（Windows），填全局 eslint 命令大概率失效
• Mac 用户常见问题：GUI 启动 Atom 时 PATH 不包含 npm 全局 bin；改用终端执行 atom --new-window 启动可继承 shell 环境
• Fix on save 失效？确认 Fixable Rules Only 已勾选，且没被 /* eslint-disable */ 或 .eslintignore 屏蔽
• 规则不生效？检查 .eslintrc.* 是否在项目根目录，且含 root: true，否则会向上递归找父级配置造成覆盖

真正容易被忽略的是：Atom 的 linter 插件不会自动 reload 项目配置。改了 .eslintrc.js 或装了新插件后，必须保存一次当前文件，才能触发新一轮 lint 并刷新所有标记——不是等几秒，是必须按 Ctrl+S/Cmd+S。