Sublime中ESLint需通过SublimeLinter框架+SublimeLinter-eslint插件实现，须本地安装eslint及依赖，配置文件命名大小写敏感且按特定顺序查找，lint_mode设为"background"可实现修改时检查。
Sublime 安装 SublimeLinter 和 eslint 插件
想在Sublime Text里用上ESLint检查？这里有个关键点：它并非原生支持，必须借助一个“中间件”组合——也就是SublimeLinter框架加上SublimeLinter-eslint插件。光在本地装了eslint的npm包可不够，Sublime自己并不会主动去调用它。
具体操作，可以按这个顺序来：
- 首先，通过Package Control安装
SublimeLinter（注意别装成SublimeLinter3，那是已经废弃的旧版本）。 - 接着，安装
SublimeLinter-eslint插件，名字必须完全匹配，大小写要敏感。 - 最后，确保你的项目根目录下有一个可运行的
eslint实例。强烈建议在项目内本地安装：npm install eslint --sa ve-dev，这样可以有效避免全局eslint版本可能带来的冲突。 - 额外提醒：如果你使用了像
eslint-config-airbnb这类扩展规则集，记得把对应的依赖包也在本地安装齐全，否则插件启动时很可能会报Failed to load config的错误。
为什么 ESLint 提示不出现？检查 PATH 和 node_modules 位置
插件SublimeLinter-eslint的工作逻辑是：它会从当前打开文件所在的目录开始，逐级向上查找node_modules/.bin/eslint这个路径。如果找不到，才会回退到使用系统环境变量PATH里的eslint。很多配置后“没反应”的情况，问题往往就出在这个查找环节。
常见的错误现象有这些：
- 保存文件后，界面上没有任何错误或警告提示，状态栏也不显示ESLint的图标。
- 打开Sublime的控制台（快捷键
Ctrl+`），能看到报错信息，比如eslint: cannot resolve command或者spawn eslint ENOENT。 - 检查只对部分文件生效，例如在
src/目录下的文件能正常提示，但根目录下的.js文件却毫无反应。
遇到这些问题，可以尝试以下排查步骤：
- 打开Sublime的控制台，输入
sublime.log_commands(True)，然后保存一个JS文件，观察控制台输出的实际eslint执行路径是否合理。 - 在终端中，切换到项目根目录，运行
npx eslint --version，确认本地的eslint是可用的。 - 如果需要强制指定eslint的路径，可以在Sublime的
Preferences → Package Settings → SublimeLinter → Settings用户设置中添加如下配置：{ "linters": { "eslint": { "executable": ["./node_modules/.bin/eslint"] } } }这里有个细节需要注意：
"executable"的值必须是一个数组，如果直接写成字符串，配置会静默失效。
JS 语法错误实时提醒靠的是 linter 触发时机，不是“实时”
首先要明确一点：Sublime Text本身并没有真正意义上的“边打字边lint”功能。我们常说的“实时”提醒，实际上指的是在文件保存时（on_sa ve）触发，或者在文件内容修改后，经过一个短暂延迟再触发（on_modified，这个模式需要手动开启）。默认情况下，检查只发生在保存文件的那一刻。
如果你想获得更接近“实时”的体验，即修改代码时就触发检查，可以这样设置：
- 打开
Preferences → Package Settings → SublimeLinter → Settings。 - 将
"lint_mode"的值从默认的"load_sa ve"改为"background"。 - 同时，建议将
"delay"参数设置为0.3（单位是秒），这样可以在你连续输入时，避免检查被过于频繁地触发，影响流畅度。 - 需要警惕的是：在
background模式下，如果你的eslint配置比较复杂，或者检查范围包含了像node_modules这样的大目录，可能会导致编辑器明显卡顿。如果遇到这种情况，应该考虑精简.eslintignore文件的内容，或者干脆切换回只在保存时检查（on_sa ve）的模式。
ESLint 配置文件没被识别？优先级和命名很关键
SublimeLinter-eslint插件会按照一个固定的顺序来查找ESLint配置文件，而且它对文件名的大小写是敏感的。在Windows系统上，经常因为将.eslintrc.js误写为.eslintrc.JS，导致配置文件被静默忽略。
插件查找配置文件的顺序是这样的（从当前正在编辑的文件所在目录开始，逐级向上搜索）：
- 优先查找
package.json文件中的eslintConfig字段。 - 然后依次尝试：
.eslintrc.cjs（Node.js CommonJS格式）、.eslintrc.js、.eslintrc.yaml或.eslintrc.yml、.eslintrc.json。 - 最后是
.eslintrc（无后缀，仅支持JSON格式）。
这里还有几个容易踩坑的地方：
- 如果你的项目里有
.eslintrc.js，但里面使用了export default这种ESM模块语法，而你的本地Node.js环境或项目package.json中设置了"type": "module"，就可能会报错Cannot use import statement outside a module。这时，必须将导出方式改为CommonJS的module.exports = {...}。 .eslintignore文件必须放在ESLint配置文件同级或者更外层的目录才会生效。文件内容每行写一个glob模式，不要加引号，注释用#开头。
最直接的验证配置是否生效的方法：在终端里，到项目目录下运行npx eslint your-file.js。如果命令行的检查结果和Sublime编辑器里给出的提示完全一致，那就说明整个配置链路已经打通了。
