Sublime怎么配置ESLint语法检查？前端项目代码规范利器

Sublime Text 本身并不具备JS语法检查能力，要实现ESLint实时检查，必须把SublimeLinter框架、SublimeLinter-eslint插件和本地安装的eslint可执行文件这三个东西串起来才能工作。缺了哪一个，ESLint都跟你装死——状态栏永远显示Plain Text或JSON，错误图标也死活不出来。

说实话，排查这类问题其实没那么玄乎，绝大多数情况都是下面几个环节出了岔子。

文件没被识别为 Ja vaScript，ESLint 根本不启动

注意右下角状态栏——如果显示的是Plain Text或者JSON，那就说明Sublime根本就没把当前文件当作Ja vaScript来处理，SublimeLinter-eslint当然也就不会启动。

解决办法？手动设定语法就行了：菜单里点View → Syntax → Ja vaScript (Babel)。相比原生Ja vaScript语法，这个方案对JSX/TSX的兼容性更好一些。

有一个容易踩坑的地方：对于.vue这类单文件组件，必须先装好Vue Syntax Highlight插件，然后确认状态栏显示的是Vue Component。哪怕你在eslint配置里写了--ext .vue，语法没认对，全部白搭。

还有些无后缀的脚本文件，比如webpack.config这种，必须手动指定语法——别指望Sublime能自动猜出来。

executable 路径填错，静默失败最常见

这算是整个配置里最容易踩坑的地方了。SublimeLinter-eslint默认会从$PATH环境变量里找eslint，但问题在于：macOS/Linux下装了多个Node版本、用了nvm/fnm，或者Windows上开了WSL，终端里which eslint返回的路径跟Sublime继承到的PATH往往就不是一回事。

怎么解决？我给你指条明路：

• 最稳妥的做法是用项目本地路径：把executable设为"./node_modules/.bin/eslint"。注意这是相对路径，Sublime会自动补全成项目根目录下的真实路径。
• 非要写绝对路径也行，macOS/Linux例子："/Users/you/project/node_modules/.bin/eslint"
• Windows用户记住一点：别填eslint.cmd，直接写eslint，插件会自动适配。
• 验证方法也很简单：打开Sublime控制台（Ctrl+`），输入import os; print(os.environ.get('PATH'))，看看输出里是不是包含which eslint返回的那个目录。

lint_mode 和 args 配置不当，检查卡顿或不修复

默认的lint_mode是["on_load", "on_modified"]，意味着每敲一个字符就调用一次eslint进程。遇到大型文件或者启用了typescript-eslint的项目，这很容易让Sublime卡住甚至假死。

调整策略其实不难：

• 改成"lint_mode": ["on_sa ve", "on_modified"]——保存时做一次完整检查，on_modified只用来做快速提示（比如括号没闭合）。
• 再加个"delay": 0.5，防止快速连打字时触发了多个子进程堆积。
• 注意一点：右下角显示ESLint: 3 errors但代码没变——这其实很正常。--fix不是默认行为，要启用自动修复，必须显式加上"args": ["--fix"]。
• 如果项目用了ESLint v8.50+的新格式eslint.config.js，必须显式指定配置文件路径："args": ["--config", "${project}/eslint.config.js"]。

.eslintrc.* 不生效，名字、位置、解析三者全要对

ESLint报“no problems detected”或者只报一些基础错误？那大概率是配置文件压根没被加载。

记住这几个要点：

• 标准命名必须用.eslintrc.js、.eslintrc.cjs、.eslintrc.json、.eslintrc.yml这几个。注意：eslint.config.js目前SublimeLinter-eslint还不支持。
• 配置文件必须放在项目根目录，或者它的任意父级目录。但前提是——Sublime必须通过Project → Add Folder to Project的方式打开整个文件夹，而不是只打开单个.js文件。
• 想确认配置文件是否被正确读取？可以在终端进项目根目录，运行eslint --print-config index.js，看输出里有没有你写的规则。输出为空或者报错，说明配置没命中。
• 还有个细节：别写"ecmaVersion": "latest"，某些旧版插件解析这个会崩溃。改成具体数字，比如2022，更稳。

说起来，最容易被忽略的一个问题是：Sublime到底有没有“认为”你打开了项目？单文件打开、拖拽文件进编辑器、或者通过快捷方式直接启动Sublime再双击文件——这些操作都会导致插件找不到node_modules/.bin/eslint，也无法向上查找配置文件。记住：必须用Project → Add Folder to Project显式加载整个目录，插件才能正常工作。