sublime text 需通过 sublimelinter 插件配合 eslint、flake8 等 cli 工具实现语法检查；须安装核心插件与语言子插件，并确保系统 path 可调用对应 linter，否则需在设置中显式配置 paths 路径。
Sublime Text 本身不带实时语法错误检查，必须靠插件实现；最稳定、通用的方案是用 SublimeLinter 配合对应语言的 linter（如 eslint、pylint、flake8）。
安装 SublimeLinter 和语言专用 linter
先装核心插件 SublimeLinter，再装具体语言支持——注意：只装 SublimeLinter 不会报错，但不会有任何提示，必须额外安装 SublimeLinter-xxx 子插件。
- 用
Package Control → Install Package依次安装：SublimeLinter、SublimeLinter-contrib-eslint（JS）、SublimeLinter-flake8（Python）等 - 确保系统已全局安装对应 CLI 工具：比如
eslint要能从终端直接运行eslint --version，否则插件找不到可执行文件 - 如果用 nvm 或 pyenv，Sublime 可能读不到 shell 的 PATH，需在
SublimeLinter.sublime-settings中显式配置paths，例如：{ "paths": { "linux": [], "osx": ["/Users/yourname/.nvm/versions/node/v18.17.0/bin"], "windows": [] } }
启用并验证 linting 是否生效
默认安装后是开启状态，但容易因配置或环境问题静默失败。验证方法很直接：
- 打开一个有明显错误的文件（比如 JS 中写
consol.log('x')） - 保存文件（部分 linter 默认仅在保存时触发），看左下角是否出现
1 error提示 - 把光标移到报错行，看是否有黄色波浪线；按
Ctrl+Shift+P输入SublimeLinter: Show all errors查看完整列表 - 如果没反应，打开
Tools → SublimeLinter → Toggle Debug，再保存一次，看控制台输出是否报linter failed to execute或can't find eslint
常见失效原因和绕过方式
不是插件没装好，而是环境链路断了。重点排查这三处：
-
SublimeLinter设置里"lint_mode": "background"必须开启（默认是），否则只在保存/聚焦时检查，不是“实时” - 项目根目录存在
.eslintrc.js或pyproject.toml等配置文件，但内容有语法错误，会导致整个 linter 退出——可临时重命名配置文件测试 - 使用了 pnpm/yarn v4+ 的 Plug'n'Play（PnP），
eslint找不到依赖，此时需改用eslint --no-warn-legacy-bundlers或切换回 npm
真正卡住的点往往不在 Sublime 设置，而在 CLI 工具能否被正确调用、配置文件是否合法、以及当前工作目录是否被 linter 正确识别为项目根。调试时优先看 Sublime 控制台（Ctrl+`）里的 SublimeLinter 日志，比反复重装插件有效得多。
