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% 能恢复。

# linux  # 虚拟环境  # win  # macos  # mac  # windows  # json  # js  # vscode  # python  # cos