SublimeLinter 是一个语法检查框架插件，本身不带检查能力，需单独安装系统级 linter（如 eslint、pylint）并配置路径，否则会报错或静默失效。
SublimeLinter 是什么，为什么不能直接装就用
SublimeLinter 本身只是个“壳”，它不自带任何语法检查能力。你装完 SublimeLinter 后发现没反应、没报错、没下划线——这完全正常。真正干活的是后端 linter 工具，比如 eslint（JS）、pylint（Python）、flake8（Python）或 shellcheck（Shell）。这些必须单独安装在系统里，且 SublimeLinter 要能通过命令行找到它们。
安装 SublimeLinter 和对应 linter 的正确顺序
顺序错了就白忙：先装系统级 linter，再装 Sublime 插件，最后配路径。否则 SublimeLinter 会报 "linter not found" 或静默失效。
- 以 Python 为例：先在终端运行
pip install pylint flake8（推荐都装，用途不同） - 打开 Sublime →
Ctrl+Shift+P（Win/Linux）或Cmd+Shift+P（Mac）→ 输入Package Control: Install Package→ 回车 → 搜索并安装SublimeLinter - 再同样方式安装对应语言的子插件，比如
SublimeLinter-pylint或SublimeLinter-flake8 - 如果 linter 不在系统
$PATH中（例如用 pyenv、nvm 管理环境），需在 SublimeLinter 设置里手动指定路径，如"executable": ["/Users/xxx/.pyenv/shims/pylint"]
常见报错和对应解法
不是所有红标都是代码写错了，很多是配置断了链：
-
"No lint results. Linter crashed."→ 检查 linter 是否真能命令行运行：pylint --version；若报 command not found，说明没装或 PATH 不对 - JS 文件没提示 → 确认已装
eslint（npm install -g eslint），并安装SublimeLinter-eslint；ESLint 需要项目根目录有.eslintrc.js或package.json中含eslintConfig - 只对部分文件生效 → 检查 Sublime 右下角显示的语法类型是否匹配（如显示 “Plain Text” 就不会触发任何 linter），用
Ctrl+Shift+P→Set Syntax: Python手动设对 - 报错位置偏移、高亮错行 → 多半是文件用了混合缩进（空格+Tab）或 BOM 头，用
File → Reopen with Encoding → UTF-8清掉 BOM，再统一用空格缩进
性能与稳定性要点
默认 SublimeLinter 是“保存时检查”，但大型文件或慢 linter（如某些 TypeScript 配置）会导致卡顿。可调成仅在编辑时检查，或加延迟：
{
"delay": 0.5,
"lint_mode": "background",
"paths": {
"linux": [],
"osx": ["/usr/local/bin", "/opt/homebrew/bin"],
"windows": []
}
}
注意："lint_mode": "background" 表示边打字边检查，但太激进会拖慢响应；"delay" 单位是秒，避免每敲一个字符都触发一次。另外，SublimeLinter 4.x 起不再兼容旧版 Sublime Text 3 build SublimeLinter 3（但已停止维护，安全性/兼容性风险明显）。
最常被忽略的一点：SublimeLinter 的配置是分层的——全局设置、语法专属设置、项目专属设置，三者冲突时项目设置优先。改完配置记得重启 Sublime，有些改动（尤其是 executable 路径）不重启不生效。
