VSCode中Python Linter不工作通常因linter路径、Python解释器、工作区设置三者不一致导致静默失效；需确认安装并启用正确linter、手动指定可执行路径、确保解释器匹配、验证linting已开启。
VSCode 中 Python Linter 不工作，通常不是插件没装，而是配置没对上——尤其是 linter 路径、Python 解释器、工作区设置三者不一致 导致的静默失效。
确认已安装并启用正确的 linter
VSCode 本身不自带 Python linter，需手动安装（如 pylint、flake8 或 pycodestyle）并告诉 VSCode 哪个在用：
- 在终端中运行
pip install pylint（或你选的 linter），确保安装成功 - 打开 VSCode 命令面板（Ctrl+Shift+P / Cmd+Shift+P），输入 Python: Select Linter，选择你刚装的那个
- 如果提示“未找到”，说明它不在当前 Python 环境的
PATH中，需要指定绝对路径（见下一条）
手动指定 linter 可执行文件路径
尤其在使用虚拟环境、conda 或多 Python 版本时，VSCode 往往找不到 linter 的实际位置：
- 先在终端激活你的 Python 环境，运行
which pylint（Linux/macOS）或where pylint（Windows）拿到完整路径 - 打开 VSCode 设置（Ctrl+,），搜索 python.linting.pylintPath
- 把刚才复制的路径粘贴进去（例如：
/Users/you/venv/bin/pylint或C:\myproject\venv\Scripts\pylint.exe） - 同理，如果是 flake8，设 python.linting.flake8Path
检查 Python 解释器是否匹配
Linter 必须和当前选中的 Python 解释器在同一环境里，否则模块导入、类型检查都会出错：
立即学习“Python免费学习笔记（深入）”；
- 按 Ctrl+Shift+P → 输入 Python: Select Interpreter，确认选中的是你装了 linter 的那个环境（比如
./venv或conda env） - 看窗口右下角是否显示了正确的解释器路径；如果显示
Python 3.x.x但没写路径，很可能用的是系统默认 Python，而非你的项目环境 - 重启 VSCode 或重新加载窗口（Ctrl+Shift+P → Developer: Reload Window）让设置生效
验证 linting 是否真正开启
有时候设置看起来对了，但 linting 其实被关掉了：
- 检查设置中 python.linting.enabled 是否为 true
- 确认没有在
.vscode/settings.json或用户设置里意外加了"python.linting.enabled": false - 打开一个
.py文件，故意写一行明显错误（如prin("hello")），等几秒看有没有波浪线或问题面板报错；没有就说明还没通
基本上就这些。多数情况是解释器和 linter 不在同一个环境，或者路径没填对。不用重装插件，也不用删缓存，对准这四点查一遍，90% 能恢复。
