SublimeLinter 无法工作通常因 Python 或 linter 路径未被识别；需在用户设置中配置 paths 或 linters.executable，并确保文件被识别为 Python、项目结构正确、linter 安装于当前 Python 环境。
Sublime Text 装不了 SublimeLinter？先确认 Python 环境是否被识别
SublimeLinter 本身不检查代码，它只是个调度器；真正干活的是后端 linter（比如 pylint、flake8）。如果你装完插件没反应，大概率是 Sublime 找不到你的 Python 或 linter 命令。
检查方法：打开 Sublime → Ctrl+`（反引号）调出控制台 → 输入 import sys; print(sys.executable)。如果报错或路径指向系统自带的旧 Python（比如 macOS 的 /usr/bin/python），就得手动指定。
- 确保你用的是自己安装的 Python（如通过 pyenv、brew、官网 pkg 安装），不是系统默认的
- 在 Sublime 中：菜单
Preferences → Package Settings → SublimeLinter → Settings，在用户设置里加这段：
{
"paths": {
"linux": [],
"osx": ["/opt/homebrew/bin", "/Users/yourname/.pyenv/shims"],
"windows": []
}
}
把 /Users/yourname/.pyenv/shims 换成你实际的 Python bin 目录（比如 which flake8 输出的路径父目录）。
flake8 和 pylint 选哪个？看场景别硬套
两者定位不同：flake8 快、轻量、侧重 PEP 8 和基础错误（比如未定义变量、缩进错）；pylint 重、全、带类型提示检查和重构建议，但容易误报、启动慢。
立即学习“Python免费学习笔记（深入）”；
- 日常写脚本、小项目，直接装
flake8：终端运行pip install flake8 - 团队项目或需要静态类型检查（比如用了
typing），再加pylint：用pip install pylint，但别同时开两个——容易冲突且无意义 - SublimeLinter 默认只启用已安装的 linter，装完不用额外开关，但可通过
SublimeLinter → Lint Mode设为background（后台实时）或save only（仅保存时）
为什么改了配置没生效？重点查这三个地方
常见现象：改了 SublimeLinter.sublime-settings 或项目根目录下的 .flake8，但 lint 结果完全不变。
- 确认你编辑的是「用户设置」（User），不是「默认设置」（Default）——后者会被覆盖
- 检查文件是否被 Sublime 识别为 Python：右下角状态栏应显示
Python，不是Plain Text；如果不是，点一下切换，或保存为.py后缀 - 项目级配置（如
.flake8）必须放在项目根目录，且 Sublime 当前打开的是该文件夹（Project → Open Project），不是单个文件——否则不读
Mac 上 command not found: flake8？别急着重装 pip
这是最典型的路径问题。macOS（尤其 M1/M2）常因 shell 配置（zsh）和包管理器（brew/pyenv）混用导致命令存在但 Sublime 找不到。
- 终端里能跑
flake8 --version，说明已装好；但 Sublime 启动时没加载你的 shell profile（比如~/.zshrc） - 解决办法：用
which flake8查到路径（比如/opt/homebrew/bin/flake8），然后在 SublimeLinter 用户设置里显式指定：
{
"linters": {
"flake8": {
"executable": ["/opt/homebrew/bin/flake8"]
}
}
}
路径错了会静默失败，不会报错，所以务必核对 which 输出。
复杂点在于：不同项目可能用不同 Python 版本，而 linter 是绑定 Python 环境的。如果你切了 pyenv 版本，记得重新 pip install flake8 到当前环境，否则 Sublime 调用的还是旧版本的二进制。
