Sublime Text中SublimeLinter代码校验插件的安装与配置

先说一个核心判断：SublimeLinter 不会自动找活干，它本质上是一个调度中心——真正负责检查代码的，是你系统里装的那些命令行工具，比如 eslint、pylint 或 flake8。如果这些工具没装、路径不对，或者 Sublime 压根没认出当前文件是 Python 还是 Ja vaScript，那插件就会保持静默，什么标记都不会出现。

安装后没反应？先排查这三件事

绝大多数“没反应”的情况，不是配置有多复杂，而是基础链路断了。经验表明，90% 的问题都卡在下面三个环节：

• Package Control 必须安装到位，并且能正常调出。按 Ctrl+Shift+P 弹出面板后，输入 Install Package 应该有响应。
• SublimeLinter 主插件本身要通过 Package Control 安装。注意，光装 SublimeLinter-eslint 或 SublimeLinter-pylint 不行，主插件是基础。
• 对应语言的命令行工具必须全局可执行。在终端里运行 eslint --version 或 flake8 --version，必须能正常返回版本号，而不是报 command not found。

这里有一个容易踩坑的地方：macOS 上如果用了 pyenv 或 Homebrew 安装 Python，flake8 通常躲在 /opt/homebrew/bin 或 ~/.pyenv/shims 目录下，Sublime 默认不会去这些路径里找。

装了 pylint 但 Sublime 仍然不标错？

这是因为 SublimeLinter 的检查触发条件比较严格：它需要语法类型被识别、子插件已安装、以及对应的二进制文件可执行，三个条件同时满足才会启动。常见的断点有这几个：

• 右下角状态栏显示的是 Plain Text 而不是 Python。点击切换，或者确保文件以 .py 结尾并已保存。
• 只装了 pylint，但没装 SublimeLinter-pylint。主插件没有能力直接调度 pylint，必须靠子插件来桥接。
• pylint 安装在虚拟环境里，而 Sublime 启动时没有加载那个环境变量。解决办法是在用户设置中显式指定路径：

  { "linters": { "pylint": { "executable": "/path/to/venv/bin/pylint" } } }

不要用 pip install pylint 在系统 Python 下装完，又指望 Sublime 用 pyenv 的 Python 去调用它——路径根本对不上。

lint_mode 选 background 还是 on_sa ve？

这取决于你写的代码类型和机器性能，两者适用场景不同：

• "lint_mode": "background" 是实时检查，每敲一个字符都触发。适合小文件、本地开发、机器比较新的情况。但如果是大文件或者老旧笔记本，可能会卡顿；而且有些 linter（比如 pylint）启动慢，会导致高亮延迟。
• "lint_mode": "on_sa ve" 只在 Ctrl+S 后检查。推荐用于团队项目、包含类型检查的场景，或者使用 pylint 时。这样能避免干扰输入节奏，也减少误报带来的干扰。

需要警惕的是，不要同时启用多个 linter。比如 flake8 和 pylint 一起开，规则重叠、反馈冲突，SublimeLinter 不会为你做去重，结果反而更难读。

配置位置：菜单 → Preferences → Package Settings → SublimeLinter → Settings，编辑的是「User」文件，不是 Default。

路径配置写错一个斜杠就失效

SublimeLinter 对 paths 和 executable 的路径格式极其敏感，尤其在 macOS/Linux 下：

• paths 是目录列表，不是文件路径。举个例子，如果 flake8 在 /Users/me/.pyenv/shims/flake8，那 paths 应该填 "/Users/me/.pyenv/shims"，而不是带 flake8 的完整路径。
• Windows 用户要注意反斜杠："C:\Users\me\AppData\Roaming\npm\eslint.cmd"，单个 \ 会被当成转义符。
• 修改完设置必须重启 Sublime，热重载不生效。

最稳妥的验证方式：打开 Sublime 控制台（Ctrl+`），输入 import os; print(os.environ.get('PATH'))，看看输出里有没有你期望的 bin 目录。Sublime 启动时只读这一份 PATH，问题往往就出在这里。