Pylint 能在 Sublime Text 3 中运行，但必须同时满足三个硬条件：pylint 命令可在终端执行、插件指向正确的 Python 环境、配置项与项目结构一致；缺一不可，否则静默失败。
直接说结论：Pylint 能在 Sublime Text 3 里跑起来，但必须满足三个硬条件——pylint 命令本身得能从终端执行、插件得指向正确的 Python 环境、配置项不能和项目实际结构冲突。缺一不可，否则只报错不报具体原因。
确认 pylint 是否可执行
很多人卡在这一步却以为是插件问题。打开终端（不是 Sublime 的控制台），运行：
pylint --version
如果提示 command not found 或 ModuleNotFoundError，说明 pylint 没装，或没装在当前 shell 使用的 Python 环境里。不要用 pip install pylint 就完事——得确认它装在你项目实际用的那个 Python 下（比如虚拟环境里的 venv/bin/python）。
- 如果你用
venv，先激活它：source venv/bin/activate（Linux/macOS）或venv\Scripts\activate（Windows），再pip install pylint - 装完后再次运行
pylint --version，确保有输出 - 记下这个 Python 环境的绝对路径，后面插件配置要用到
选对插件：Pylinter 还是 SublimeLinter-pylint？
Sublime Text 3 里有两个主流方案，别混用：
立即学习“Python免费学习笔记（深入）”；
-
Pylinter：独立插件，配置简单但维护停滞，只支持旧版pylint（≤2.12），且不兼容pyproject.toml配置 -
SublimeLinter-pylint：基于 SublimeLinter 框架，支持新版pylint（≥2.14）、pyproject.toml和多 Python 版本切换，推荐首选
安装方式统一：按 Ctrl+Shift+P → 输入 Install Package → 搜 SublimeLinter，先装 SublimeLinter 核心，再装 SublimeLinter-pylint。装完后，它不会自动启用，得手动触发一次 lint —— 保存一个 .py 文件，或按 Ctrl+Shift+P → SublimeLinter: Lint Current View。
SublimeLinter-pylint 的关键配置项
打开 Preferences → Package Settings → SublimeLinter → Settings，写进用户配置（不是默认配置）：
{
"linters": {
"pylint": {
"executable": "/path/to/your/venv/bin/python -m pylint",
"args": ["--rcfile", "/path/to/pylintrc"],
"disable": false
}
}
}
注意三点：
-
executable必须是完整命令形式，不能只写/path/to/pylint；新版pylint推荐用python -m pylint启动，避免路径解析问题 -
args中的--rcfile是可选的，但如果你有自定义.pylintrc或pyproject.toml，必须显式指定路径，否则它只读当前目录下的配置 - 别在配置里写
"disable": true—— 这个开关容易被忽略，导致 lint 完全不触发
常见错误现象与对应解法
保存后没反应？图标不显示？报一堆 ImportError？这些不是“配置没生效”，而是环境链断了：
- 现象：
SublimeLinter: pylint output: No module named 'pylint'
→ 实际是插件调用的 Python 解释器里没装pylint，不是你终端里那个 - 现象：只检查语法，不报
E类错误（比如未定义变量）→ 检查pylint版本是否 ≥2.14，旧版本默认关闭部分检查器 - 现象：路径含中文或空格时报错 → 把项目移到纯英文路径下测试，SublimeLinter 对非 ASCII 路径支持不稳定
- 现象：
pylint检出错误但 Sublime 不标红 → 关闭其他 lint 插件（如SublimeLinter-flake8），它们会互相抢占 lint 结果
最麻烦的一点是：SublimeLinter 默认缓存 linter 可执行路径，改完配置后得重启 Sublime 才生效，光重载插件没用。
