Sublime Text 不报错是因为未找到 pylint,需手动配置其父目录路径、启用 linter、确保文件语法为 Python、以文件夹形式打开项目并正确放置 .pylintrc。

Sublime Text 装了 SublimeLinter-pylint 却不报错?不是插件坏了,而是它根本没找到你系统里真正的 pylint —— 它压根没启动。
确认 Sublime Text 启动时能访问到你的 Python 和 pylint
Sublime Text 不继承 shell 的环境变量(比如 .zshrc 或 .bash_profile),所以你在终端里能跑 pylint --version,不代表 Sublime 能调用它。
- 在终端运行
which pylint,记下完整路径,例如/Users/alex/.pyenv/shims/pylint或/opt/homebrew/bin/pylint - 这个路径的**父目录**(不是
pylint文件本身)才是要填进配置里的:/Users/alex/.pyenv/shims或/opt/homebrew/bin - 打开 Sublime → Preferences → Package Settings → SublimeLinter → Settings,在用户配置中加:
{
"paths": {
"osx": ["/Users/alex/.pyenv/shims"],
"linux": [],
"windows": ["C:\Users\alex\AppData\Roaming\Python\Python312\Scripts"]
}
}
Windows 用户注意:填的是 pylint.exe 所在目录,不是文件全路径;macOS 用户尤其别填 /usr/bin —— 那是系统旧 Python,不带 pylint。
检查 linter 是否被 SublimeLinter 实际启用
装完插件不等于自动启用。SublimeLinter 默认只启用已安装且配置正确的 linter,如果配置里关掉了或根本没声明,它就彻底静默。
立即学习“Python免费学习笔记(深入)”;
- 确认用户设置中有类似这段(不是默认配置,是「User」设置):
{"linters": {"pylint": {"disable": false}}}
- 确保你打开的是
.py文件,且右下角状态栏显示 “Python”,不是 “Plain Text” - 如果项目用了虚拟环境,
pylint必须装在那个环境下:source venv/bin/activate && pip install pylint;全局安装的对虚拟环境项目无效
项目级 .pylintrc 不生效?你可能没“以文件夹形式打开项目”
SublimeLinter 只在通过 Project → Open Folder 打开整个目录时,才向上查找根目录下的 .pylintrc。双击打开单个 .py 文件,它完全看不到这个配置。
- 在项目根目录运行:
pylint --generate-rcfile > .pylintrc - 编辑
.pylintrc,找到[MESSAGES CONTROL]段,改这一行:disable=missing-docstring,invalid-name,R,C - 保存后无需重启,修改立刻生效 —— 但前提是 Sublime 当前是以文件夹方式加载该项目
别同时开 pylint 和 flake8,它们不兼容
二者定位不同:flake8 轻、快、专注 PEP 8 + 基础错误(E/F 类);pylint 重、全、带类型推断和重构建议,但启动慢、易误报。SublimeLinter 不会合并结果,反而容易冲突、重复报错、拖慢响应。
- 选一个就够了:日常快速反馈用
flake8;团队项目或用了typing就上pylint - 如果已装两个,务必在 SublimeLinter 设置里禁用其中一个:
{"linters": {"pylint": {"disable": true}, "flake8": {"disable": false}}} - 别指望靠改
SublimeLinter主配置里的ignore字段来过滤 pylint 警告 —— 那是给老插件Pylinter用的,现在主流是SublimeLinter-pylint,它只认.pylintrc
最常被忽略的一点:路径填错父目录、项目没用文件夹方式打开、.pylintrc 放错位置 —— 这三处任一出问题,配置就等于白写。


















