Sublime本身不检测语法错误，必须靠SublimeLinter框架+eslint CLI工具协同工作；只装插件不装CLI工具或executable路径配置错误，会导致静默失效或“linter not found”错误。
Sublime 本身不检测语法错误，必须靠 SublimeLinter 框架 + 对应语言的 CLI 工具（如 eslint、flake8）协同工作；只装插件不装 CLI 工具，必然报 linter not found 错误，且路径配置错误是卡在最后一步的最常见原因。
为什么装了 SublimeLinter-eslint 还是没反应？
根本原因不是插件没装对，而是 eslint 命令在终端里都跑不起来。SublimeLinter-eslint 只是“翻译器”，它需要调用系统里真实存在的 eslint 可执行文件。
- 在终端执行
which eslint（macOS/Linux）或where eslint（Windows），确认命令是否在PATH中 - 若用
nvm管理 Node 版本，eslint路径会随 shell 启动动态变化，Sublime 启动时可能读不到——建议改用 nvm 的default版本，或在 Sublime 启动前先运行nvm use default - Windows 用户注意：
eslint.cmd和eslint是两个文件，SublimeLinter 默认找的是eslint；若全局安装后只有eslint.cmd，需在设置里显式指定"executable": ["eslint.cmd"]
如何避免敲一个字就卡顿？
默认 lint_mode 是 ["on_load", "on_modified"]，意味着每按一次键都会触发一次 eslint 调用，尤其在大型 JS 文件 + typescript-eslint 场景下极易卡住。
- 把
lint_mode改成"background"：只在保存或空闲时检查，不打断输入流 - 若仍想保留“修改即检”，可加
"delay": 1000（单位毫秒），等用户停手 1 秒再触发 - 对 TypeScript 项目，务必确认
typescript-eslint的 parserOptions.project 是否指向正确的tsconfig.json，否则每次 lint 都会重解析整个项目，CPU 直接拉满
本地 node_modules/eslint 怎么正确配置？
项目级 eslint 比全局更可靠，但路径写错会导致 executable 找不到，报错信息还是 linter not found。
- Linux/macOS：填绝对路径，例如
"/path/to/project/node_modules/.bin/eslint"；注意别漏掉.bin/子目录 - Windows：用正斜杠或双反斜杠，例如
"C:/project/node_modules/.bin/eslint"或"C:\project\node_modules\.bin\eslint"；单反斜杠会被当转义符处理 - 如果项目用了 pnpm 或 yarn v3+（有 .pnp.cjs），
node_modules/.bin可能不存在，此时需改用"executable": ["npx", "--no-install", "eslint"]，但要注意npx启动慢，更适合background模式
配置文件（.eslintrc.*）为什么有时不生效？
SublimeLinter-eslint 会从当前文件所在路径向上逐层查找配置文件，但顺序和大小写敏感性容易被忽略。
- 查找顺序严格为：
.eslintrc.js→.eslintrc.cjs→.eslintrc.yaml→.eslintrc.yml→.eslintrc.json→package.json中的eslintConfig字段 -
.eslintrc（无后缀）和.eslintrc.JS（大写）均无效；必须小写且带合法后缀 - 若项目根目录有
.eslintignore，确保它没把当前文件路径意外排除——SublimeLinter 不会提示“被 ignore”，只会静默跳过
最常被绕过的其实是环境一致性：编辑器里看到的错误，和 CI 流水线里跑 eslint . 输出不一致，大概率是因为 Sublime 调用的 eslint 版本、解析器、甚至 Node 版本，和项目实际依赖的不匹配。建议所有团队成员统一用 corepack 或 nvm 锁定版本，并在 package.json 的 scripts 里明确定义 lint 命令。这样连调试都省一半力气。
