VS Code中Pylint不报错，根本原因是分析器未加载成功，必须同时满足：已安装Python扩展、项目根目录存在.pylintrc等配置文件、终端执行python -m pylint --version能返回版本号。
VS Code 本身不运行代码分析，真正起作用的是你装的扩展 + 本地能跑起来的 CLI 工具（比如 pylint、flake8 或 pyright）。只装插件不装工具、或工具装了但没配对路径，分析就永远不会触发。
为什么保存后没报错？检查三个硬性条件是否全满足
很多用户以为装了 Pylint 就万事大吉，结果改了 prin("hello") 也没提示——根本原因是分析器压根没加载成功。必须同时满足：
- VS Code 已安装对应语言扩展（如 Microsoft 的
Python扩展） - 项目根目录存在合法配置文件（
.pylintrc、pyproject.toml或setup.cfg） - 在终端执行
pylint --version或flake8 --version能成功返回版本号（说明工具可被找到且可用）
缺一不可。尤其注意第三点：如果你用 poetry 或 venv，pylint 必须装在当前激活的环境中，而不是全局；否则 VS Code 启动时找不到可执行文件。
Python 扩展的 linting 配置和 CLI 行为不一致怎么办
VS Code 的 Python 扩展默认用自己的方式调用 linter，但它读取的是 python.linting.pylintArgs 这类设置，和你在终端里直接跑 pylint 的参数可能不同。常见后果是编辑器里不报错，终端里却报一堆。
立即学习“Python免费学习笔记（深入）”；
- 在
settings.json中显式指定配置文件路径："python.linting.pylintArgs": ["--rcfile=.pylintrc"] - 如果用
pyproject.toml，则写成："python.linting.pylintArgs": ["--config=pyproject.toml"] - 避免混用多个 linter（比如同时开
pylint和pylama），后者已停更，容易冲突 - 确认
python.defaultInterpreter指向的解释器环境里确实装了你要用的 linter
状态栏图标灰色或报错？从终端开始排查
右下角看到 Pylint 图标是灰色，或点开显示 Failed to load module，别急着重装插件——先打开集成终端（Ctrl+`），手动执行：
python -m pylint --version
如果报 No module named pylint，说明当前解释器没装；如果报 command not found，说明没加到 PATH 或不在虚拟环境里。这时：
- 确保已激活虚拟环境（
source .venv/bin/activate或.venv\Scripts\activate） - 运行
pip install pylint（不是pip install --user pylint，后者可能不被 VS Code 识别） - 重启 VS Code，再看状态栏图标是否变绿
最常被忽略的一点：VS Code 的 Python 扩展不会自动继承 shell 的 PATH，它依赖你选中的解释器环境。哪怕你在终端里能跑 pylint，只要没把它装进当前项目解释器，编辑器就看不到任何分析结果。
