Sublime Text 需通过 SublimeLinter 框架+对应语言 linter 插件（如 SublimeLinter-eslint）实现语法检查，且必须预先全局安装 CLI 工具（如 eslint、pylint），并正确配置可执行文件路径；否则将出现“linter not found”或静默失效。
Sublime Text 本身不带语法检查功能，必须通过插件实现；最常用、维护活跃的是 SublimeLinter 框架 + 对应语言的 linter（如 eslint、pylint、shellcheck）。
安装 SublimeLinter 和对应语言 linter 插件
不能只装 SublimeLinter 就完事——它只是调度器，真正做检查的是外部命令行工具（比如你写 Python，得先装好 pylint 或 flake8），再装 Sublime 的适配插件。
- 用
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS）打开命令面板，输入Package Control: Install Package回车 - 搜索并安装：
SublimeLinter（核心框架） - 再分别安装对应语言的子插件，例如：
SublimeLinter-pylint、SublimeLinter-eslint、SublimeLinter-shellcheck - 确保系统已全局安装对应 CLI 工具：比如
npm install -g eslint、pip install pylint，否则插件会报"linter not found"
配置 linter 路径和启用状态
如果 CLI 工具不在系统 PATH 中（常见于 macOS 使用 Homebrew 安装、或 Windows 使用 nvm 管理 Node 版本），SublimeLinter 找不到可执行文件，就会静默失效。
- 打开
Preferences → Package Settings → SublimeLinter → Settings - 在右侧面板（用户设置）中添加路径映射，例如：
{
"linters": {
"eslint": {
"executable": ["/opt/homebrew/bin/eslint"]
},
"pylint": {
"executable": ["/usr/local/bin/pylint"]
}
}
}
- 也可用
"disable": true临时关闭某 linter，避免干扰 - 检查是否启用：打开一个文件后，状态栏左下角应显示当前激活的 linter 名称（如
ESLint）
常见错误现象与排查方向
装完没反应？标红但提示不准确？大概率不是插件问题，而是环境链路断了。
- 状态栏无 linter 名称 →
SublimeLinter未启用，或文件类型未被识别（检查右下角语法模式是否为Python、JavaScript等） - 报错
"command not found: eslint"→ CLI 工具未安装，或路径不对；在终端运行which eslint确认真实路径 - 检查生效但只标红不显示具体错误 → 子插件未装（如装了
SublimeLinter却漏装SublimeLinter-eslint） - 保存后才检查？默认是实时检查（on-save 可关，但不建议）；若延迟明显，可能是项目 node_modules 太大，考虑在项目根目录加
.sublimelinterrc限制范围
最关键的其实是 CLI 工具本身的配置文件（如 .eslintrc.js、.pylintrc）是否生效——SublimeLinter 只是把它们原样传给底层命令，它不参与规则解析。
