必须安装linter-eslint插件并手动配置ESLint路径：优先填项目内./node_modules/.bin/eslint，或用which/where查出的全局绝对路径；同时确保项目根目录存在有效.eslintrc.js等配置文件，否则检查静默失效。
Atom 本身不内置 ESLint 支持，必须手动安装 linter-eslint 插件并正确关联本地或全局的 eslint 可执行文件，否则会提示 “ESLint not found” 或检查完全不生效。
安装 linter-eslint 插件并启用
直接在 Atom 的 Settings → Install 页面搜索 linter-eslint，点击 Install 即可。安装后它默认启用，但不会自动工作——因为插件只负责调用 ESLint，不自带引擎。
常见错误现象：
– 文件打开后无任何波浪线提示
– 手动触发 Cmd+Shift+P（macOS）或 Ctrl+Shift+P（Windows/Linux）运行 “Linter: Lint” 仍无反应
– 控制台（View → Developer → Toggle Developer Tools）报错 Failed to spawn eslint
- 确保 Atom 是最新稳定版（v1.60+），旧版对现代 Node.js 兼容性差
- 禁用其他冲突的 linter 插件（如
linter-jshint），避免规则覆盖或进程抢占 - 插件安装后无需重启 Atom，但若之前已打开项目，建议关闭再重开以刷新环境
配置 ESLint 引擎路径（关键步骤）
linter-eslint 默认尝试从项目根目录的 node_modules/.bin/eslint 启动，找不到就回退到全局安装路径。但很多用户装了全局 eslint 却仍失败，是因为 Atom 的 GUI 启动方式不继承 shell 的 $PATH。
解决方法：在插件设置页（Settings → Packages → linter-eslint → Settings）中手动填写 ESLint Path：
- 本地项目优先填：
./node_modules/.bin/eslint（相对路径，需项目含eslint依赖） - 全局安装且想统一用一个版本，先运行
which eslint（macOS/Linux）或where eslint（Windows CMD）查路径，再填绝对路径，例如：/usr/local/bin/eslint或C:\Users\Me\AppData\Roaming\npm\eslint.cmd - 如果使用
npx eslint工作流，不能直接填npx—— 插件不支持 shell 命令解析，必须指向可执行文件
确保项目有有效 ESLint 配置
即使插件和引擎都就位，没有配置文件，ESLint 也会静默跳过检查。它按顺序查找：.eslintrc.js、.eslintrc.cjs、.eslintrc.json、.eslintrc.yaml、package.json 中的 eslintConfig 字段。
典型问题场景：
– 新建空项目，只装了 eslint 但没初始化配置 → 检查无报错也无提示
– 配置文件语法错误（如 JS 配置里用了 top-level await）→ 插件报 Cannot read config file
- 快速生成配置：在项目根目录运行
npx eslint --init，按向导选风格（如 “JavaScript modules (import/export)” + “React” + “ES2020” + “style guide”） - 若用 TypeScript，必须额外安装
@typescript-eslint/parser和@typescript-eslint/eslint-plugin，并在配置中指定parser和plugins - 配置中的
root: true很重要，防止向上级目录意外继承其他配置
调试与验证是否真正生效
别只看有没有红色波浪线——要确认是 ESLint 在报错，而不是别的插件或语法高亮干扰。
- 临时写一行明显违规代码，例如
var a = 1;（若配置了no-var），看是否立刻标红并显示对应规则 ID（如no-var） - 打开 Atom 开发者工具（
Cmd+Alt+I），切到 Console 标签，修改保存文件后观察是否有linter-eslint: linting...日志 - 若仍不工作，在项目根目录终端运行
npx eslint . --ext .js,.jsx，确认 CLI 能正常输出错误 —— 如果 CLI 正常而 Atom 不行，问题一定出在路径或环境变量
最易被忽略的一点：Atom 的 GUI 进程启动时不会加载 shell profile（如 ~/.zshrc），所以即使你在终端里能跑 eslint，Atom 里也可能找不到。硬编码 ESLint Path 是唯一可靠解法。
