SublimeLinter不是装上就自动工作的语法检测框架，它必须和系统级linter工具、语言子插件、正确环境变量三者同时对齐，缺一不可；否则保存文件时静默失效——不报错、不标红、不提示，链路中断却无任何反馈。
SublimeLinter 不是装上就自动工作的语法检测框架，它必须和系统级 linter 工具、语言子插件、正确环境变量三者同时对齐，缺一不可。否则保存文件时静默失效——不报错、不标红、不提示，你只会以为“没反应”，其实链路早就断了。
确认终端能跑通对应 linter 命令
SublimeLinter 本身不带任何检查逻辑，只负责调用你本地已安装的 CLI 工具（比如 eslint、flake8、jshint）。
- 打开终端，运行 eslint --version（JS）或 flake8 --version（Python），有版本号输出才算通过
- 若报 command not found，说明没装，或装了但不在 PATH 里
- Windows 用户注意：SublimeLinter-eslint 只认 eslint，不是 eslint.cmd；macOS/Linux 用户若用 nvm 或 pyenv，终端能跑不代表 Sublime 能跑
插件安装顺序不能错：先主框架，再语言子插件
SublimeLinter 是调度器，SublimeLinter-eslint 是 JS 适配器，二者缺一不可，且必须按顺序装：
- 先用 Ctrl+Shift+P → Package Control: Install Package → 搜 SublimeLinter（注意：无下划线，不是 SublimeLinter_sublime）并安装
- 重启 Sublime Text（部分版本不重启会导致后续插件注册失败）
- 再搜 SublimeLinter-eslint（JS）或 SublimeLinter-flake8（Python）安装
- 装完打开一个 .js 文件，右下角状态栏必须显示 JavaScript（不是 Plain Text），否则不会触发任何检查
Sublime 启动时的 PATH 和终端不一致，得手动补
GUI 应用（如双击启动的 Sublime）通常不继承 shell 的PATH，尤其 macOS 和某些 Linux 桌面环境：
- 在 Sublime 控制台（Ctrl+`）中执行 import os; print(os.environ.get('PATH'))，对比终端里的 echo $PATH
- 若不一致，编辑 Preferences → Package Settings → SublimeLinter → Settings – User，写入：
- macOS（Homebrew）："jshint": {"env": {"PATH": "/opt/homebrew/bin:/usr/local/bin"}}
- Windows："eslint": {"env": {"PATH": "C:\Users\YourName\AppData\Roaming\npm"}}
- 更稳妥的方式是直接指定可执行文件路径："executable": "/opt/homebrew/bin/eslint"lint_mode 设成 "save" 才真正可控
默认lint_mode 是 ["on_load", "on_modified"]，意味着每敲一个字符都调一次 eslint，极易卡顿或误报：
- 大型文件编辑时 CPU 占用飙升
- 未闭合引号、括号等中间态会触发大量假错误
- 在用户设置里明确写："lint_mode": "save"（字符串，不是数组）
- 这样只有按 Ctrl+S 时才校验，既准又轻量
容易被忽略的点是：Sublime 的环境变量和你每天敲命令的终端根本不是同一个上下文，哪怕 eslint --version 回车就出结果，Sublime 也可能完全找不到它——验证必须在 Sublime 控制台里做，不能靠终端“感觉没问题”。
