Atom编辑器配合ESLint插件实现JavaScript代码规范检查-atom-PHP中文网

必须先安装linter核心包（作者steelbrain），再装linter-eslint并执行window: reload；vue文件需勾选lint html files、安装eslint-plugin-html/vue、配置overrides指定processor，且.eslintrc.js须位于项目根目录并设root: true。

atom编辑器配合eslint插件实现javascript代码规范检查

装了 linter-eslint 却没任何红线？不是插件坏了，是 Atom 的 ESLint 集成有明确依赖链和路径要求，漏掉一环就彻底静默。

必须先装 `linter` 核心包，再装 `linter-eslint`

Atom 1.24+ 版本起强制拆分架构：linter 是底层事件监听与 UI 渲染框架，linter-eslint 只是它的一个“语言适配器”。不装前者，后者根本注册不上，设置页都可能不显示。

在 Atom Settings → Install 里搜 linter（作者 steelbrain），安装并重启
再搜 linter-eslint 单独安装，别指望“一键全包”
装完必须执行 Window: Reload（快捷键 Ctrl+Alt+R / Cmd+Alt+R），否则配置缓存不刷新，插件形同虚设

`linter-eslint` 设置里两个开关决定是否“看得见错误”

进 Settings → Packages → linter-eslint → Settings，以下两项直接影响报错是否触发：

Java注释规范Skills

当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。

下载

勾选 Lint HTML Files：Vue 单文件组件（.vue）里的 <script></script> 块默认被当 HTML 处理，不开这个，JS 规则压根不跑
取消勾选 Disable when no ESLint config is found：否则项目根目录没 .eslintrc.js 或 package.json 里没 eslintConfig 字段，插件直接静默退出，连错误日志都不打
若用全局 ESLint（npm install -g eslint），必须勾上 Use global ESLint installation；否则插件默认去项目 node_modules/.bin/eslint 找，找不到就罢工

`.eslintrc.js` 必须存在且路径正确，Mac 用户尤其注意环境变量

linter-eslint 默认只读项目根目录下的 .eslintrc.js、.eslintrc.json 或 package.json 中的 eslintConfig 字段，完全不认全局配置（比如 ~/.eslintrc.js）。

推荐用 npx eslint --init 在项目根目录生成配置，避免手写遗漏 root: true —— 没这行，ESLint 可能向上遍历父目录找配置，导致规则冲突或意外禁用
Mac 用户常因双击图标启动 Atom 导致 Node 环境缺失 PATH：改用终端执行 atom --new-window 启动，才能继承 shell 环境，让 eslint CLI 可被找到
如果项目用 TypeScript + JSX 混合文件（如 .tsx），prettier-atom 默认 parser 会失败 —— 必须在项目根目录 .prettierrc 里显式加 "parser": "typescript"，否则整文件跳过格式化

Vue 文件校验失效？多半是解析器和插件没配齐

即使开了 Lint HTML Files，.vue 文件里的 JS 仍可能被错当成普通 HTML 字符串解析，导致规则不触发或报错错乱。

确保已安装 eslint-plugin-html：npm install eslint-plugin-html --save-dev

在 .eslintrc.js 中加 overrides，把 .vue 文件交给正确处理器：

overrides: [{ files: ["*.vue"], processor: "vue/vue", rules: { "no-unused-vars": "off" } }]

processor: "vue/vue" 依赖 eslint-plugin-vue，没装它，这条配置会让 ESLint 启动失败
main.js 报 no-new 不是 bug：Vue 2 的 new Vue({}) 被规则拦截是正常行为。只应在该行加 // eslint-disable-next-line no-new，别全局关规则