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 后缀,校验才真正开始。










