sublime如何配置ESLint语法检查_sublime实时校验JS代码教程【教程】

sublime Text 需安装 SublimeLinter + SublimeLinter-eslint 插件实现 ESLint 实时校验，关键在于正确配置 node.js 路径、确保 ESLint 已安装并可命令行调用、启用 “lint_mode”: “background” 和 “args”: [“–fix”]，并检查语法识别、配置文件存在性及文件是否已保存。

sublime text 本身不内置 ESLint 支持，必须通过插件桥接；直接安装 SublimeLinter + SublimeLinter-eslint 才能实现实时校验，但多数人卡在 Node.js 路径、ESLint 全局/项目级冲突、或未启用 eslint --fix 自动修复这三处。

确认 ESLint 已正确安装并可命令行调用

SublimeLinter-eslint 不会帮你装 ESLint，它只调用你系统里已有的 eslint 命令。如果终端执行 eslint --version 报错，Sublime 一定报 ESLint not found。

• 优先使用项目本地安装：

  npm install eslint --save-dev

  ，再配 node_modules/.bin/eslint 路径（更稳定）

• 若用全局安装（npm install -g eslint），需确保 Sublime 能读取你的 shell 环境 PATH——macos/linux 用户常需在 Sublime 启动方式上改用终端命令 subl，而非双击图标
• windows 用户注意：不要用 eslint.cmd 当可执行路径，SublimeLinter-eslint 只认 eslint（它会自动补 `.cmd`）

SublimeLinter-eslint 的关键配置项

配置文件路径为 Preferences → Package Settings → SublimeLinter → Settings，重点调以下几项：

• "executable": 必须指向真实存在的 eslint 可执行文件，例如：

  "executable": "/path/to/node_modules/.bin/eslint"

  （macOS/Linux）或

  "executable": "C:\myproject\node_modules\.bin\eslint"

  （Windows）

• "lint_mode": "background" 启用实时校验（默认是 on_save）
• "args": ["--fix"] 加上这行才能保存时自动修复（⚠️但仅限可安全修复的规则，如引号、分号）
• 若项目用 typescript 或 vue，需额外加 --ext .js,.jsx,.ts,.tsx,.vue 到 args

为什么保存后没提示错误？常见断点检查

不是插件没装好，而是校验链某环断了。按顺序排查：

• 打开 Sublime 控制台（Ctrl+` 或 Cmd+`），看是否有 SublimeLinter: eslint: xxx.js Error 日志——没有则说明根本没触发校验
• 检查当前文件是否被识别为 javaScript 语法（右下角状态栏显示，不是 Plain Text 或 json）
• 确认项目根目录有 .eslintrc.js / .eslintrc.json 或 package.json 中含 eslintConfig 字段；否则 ESLint 用空配置，几乎不报错
• 如果用了 Prettier，别把 prettier 规则直接写进 .eslintrc，应通过 eslint-config-prettier 关闭冲突规则，否则大量规则失效

最易被忽略的是：SublimeLinter 默认只对「已保存的文件」校验，新建未保存的 untitled 文件不会触发。写代码时先 Ctrl+S 保存成 .js 后缀，校验才真正开始。