根本原因是Atom 1.24+需先安装核心插件linter（steelbrain作者），再装语言provider（如linter-eslint）；否则静默失败。需重启Atom、校准ESLint路径与Node环境、确保配置在项目根目录。
Atom 安装 linter 插件失败：找不到 linter 或安装后不生效
根本原因不是插件不存在，而是 Atom 1.24+ 版本起强制要求先装核心依赖 linter（基础框架），再装具体语言检查器（如 linter-eslint）。只装后者会静默失败，界面无报错但没提示。
- 打开 Atom → Preferences → Install，搜索并安装
linter（作者是steelbrain） - 再单独安装对应语言的 provider，比如 JavaScript 用
linter-eslint，Python 用linter-flake8 - 别装名字带
linter-但作者不是官方维护者的同名插件，容易兼容性出问题 - 装完重启 Atom，或手动执行
Window: Reload（Cmd+Alt+R/Ctrl+Alt+R）
配置 ESLint 提示不显示：路径、规则或 Node 环境没对上
linter-eslint 不是开箱即用的，它默认调用项目本地的 eslint，如果没装、路径错、或全局和本地版本冲突，就会“检测到错误但不标红”。
- 确认项目根目录有
node_modules/eslint，或全局装了且eslint --version能运行 - 在
linter-eslint设置页勾选Use global ESLint installation（仅当确定全局可用时） - 若用
eslint-config-airbnb类扩展包，确保.eslintrc.js里extends路径正确，且相关包已npm install - Atom 的 Node 环境可能和终端不一致：Mac 用户常因 Shell 启动方式（GUI vs Terminal）导致
PATH缺失，可改用atom --new-window从终端启动来继承环境
保存时自动修复失效：Fix on save 选项不起作用
这个功能依赖 ESLint 自身的 --fix 能力，不是 Atom 插件单方面控制。很多规则（比如缩进、分号）能修，但涉及逻辑的（如变量重命名、删除未使用代码）不会自动改。
- 在
linter-eslint设置中开启Fix on save，同时确保ESLint Options → Fixable Rules Only是勾选状态 - 检查当前文件是否被
.eslintignore忽略，或/* eslint-disable */注释临时关闭了规则 - 如果用了 Prettier，
linter-eslint和prettier-atom可能冲突——建议只留一个格式化入口，优先用prettier-atom做格式，ESLint 专注报错 - 某些语法（如 TypeScript + JSX 混合）需要额外配置
parserOptions，否则--fix直接跳过整文件
为什么有些错误只在终端 eslint 里报，Atom 里看不到？
常见于解析器或插件配置没同步到 Atom。Atom 插件读的是项目配置，但可能因为缓存、路径权限或配置文件格式（YAML/JS/JSON 混用）导致加载失败。
- 打开 Atom 控制台（
View → Developer → Toggle Developer Tools），切到 Console 标签，保存文件时看有没有Failed to load config或Cannot find module报错 - 检查
.eslintrc.*文件是否在当前打开的 Atom 项目根目录下——Atom 不会跨父目录向上查找配置 - 如果用
eslint-plugin-import，确保settings.json里"import/resolver": { "node": { "paths": ["src"] } }这类路径是相对于项目根的，不是 Atom 安装目录 - Windows 用户注意路径分隔符：配置里写
src\components可能失败，统一用/或双反斜杠
Atom 的 linter 体系本质是“把命令行工具嵌进编辑器”，所有异常都源于环境链断裂：Node 找不到、配置读不对、插件没配齐。最容易忽略的是 Atom 启动方式带来的环境差异，以及配置文件必须严格落在项目根这一条硬限制。
