sublime text 本身不标红语法错误，必须依赖 sublimelinter 框架与 eslint、flake8 等 cli 工具协同工作；只装插件未装 cli 工具或 paths 路径配置错误会导致完全静默失效——无波浪线、无报错、控制台也无日志。
Sublime Text 本身不标红语法错误，必须靠 SublimeLinter 框架 + 对应语言的 CLI 工具（如 eslint、flake8）协同工作；只装插件不装 CLI、或 paths 配错，就会完全静默——没波浪线、没报错、控制台也没日志。
为什么装了 SublimeLinter 却没任何红线？
根本原因不是插件没生效，而是某条链断了：Sublime 启动时读不到你终端里能跑通的命令。常见断点：
-
SublimeLinter装了，但SublimeLinter-eslint或SublimeLinter-flake8没装——子插件才是“翻译器”，缺它就收不到结果 - 终端里
eslint --version成功，但 Sublime 不继承 shell 的PATH（尤其 macOS 用 nvm、Windows 用 nvm-windows 时） - 项目根目录下有
.eslintrc.js，但它本身语法错误（比如多一个逗号），eslint直接退出，不报错也不标红 - 文件语法被识别为
Plain text而非JavaScript或Python——右下角状态栏看一眼当前 syntax 名称
如何验证 eslint / flake8 是否真被调用？
别猜，直接看日志：
- 打开
Tools → SublimeLinter → Toggle Debug - 在 JS 文件里写个明显错误，比如
consol.log(1) - 保存或修改后，按
Ctrl+`打开控制台，观察输出
如果出现 linter failed to execute 或 can't find eslint，说明路径问题；如果出现 ESLint couldn't find a configuration file，说明配置文件缺失或内容非法；如果控制台完全没输出，且左下角无 error 计数，大概率是 lint_mode 关了，或子插件根本没装。
关键配置项怎么设才不踩坑？
打开 Preferences → Package Settings → SublimeLinter → Settings，用户设置里至少确认这三项：
-
"lint_mode": "background"：确保实时响应；Python 下可放心开"on_modified"（flake8极快），JS 建议保持默认"background"（避免频繁触发卡顿） -
"paths"必须显式配：尤其 macOS 用 nvm、Windows 用 nvm-windows 时，例如：{"paths": {"osx": ["/Users/xxx/.nvm/versions/node/v18.17.0/bin"], "windows": ["C:\Program Files\nodejs\"]}} -
"linters"下对应语言的"disable": false要打开；比如 Python 用户若用了pylint，还需手动加--enable=unused-variable到"args"里，否则默认不报未使用变量
真正容易被忽略的是：Sublime 启动时的环境变量和 CLI 工具的安装层级。全局安装（npm install -g eslint）在 GUI 环境下经常不可见，更稳妥的做法是把 node_modules/.bin/eslint 或 venv/bin/flake8 的绝对路径写进 paths，而不是依赖系统 PATH。
