VSCode中配置Python代码的自动检查规则-VSCode-PHP中文网

vscode python linting不报错，是因为python.linting.enabled和具体linter开关（如python.linting.pylintenabled）未同时启用、解释器未选对含linter的环境、或linter未安装在该解释器路径下，三者缺一不可。

vscode中配置python代码的自动检查规则

VSCode 的 Python 自动检查不是“装完插件就自动生效”，它卡在三个必须同时满足的环节上：python.linting.enabled 必须为 true，解释器必须选对，且对应环境里得真有 linter 可执行文件。

python.linting.enabled 是总开关，关着就全没用；只开它还不够，还得开具体工具（比如 python.linting.pylintEnabled 或 python.linting.flake8Enabled）
右下角状态栏显示的 Python 版本，必须是你 pip install pylint 或 pip install flake8 所在的环境路径——选错解释器，VSCode 就找不到 pylint 命令，报 Command 'pylint' not found
Windows 用户尤其注意：如果解释器路径含空格（如 C:\Program Files\Python311\python.exe），pylint 很可能启动失败；建议统一用虚拟环境（.venv），路径干净又隔离

两者不能共存于同一配置中，VSCode 只允许启用一个 linter。选哪个，取决于你当前最想守住的底线。

testing-python

使用pytest编写和评估有效的Python测试。适用于编写测试、审查测试代码、调试测试失败或提高测试覆盖率。

下载

用 pylint：适合已有一定规范基础的项目，它查得细——变量未使用、缺少 docstring、命名不符合 PEP 8、潜在的 AttributeError 都会标；但默认规则太严，建议配 .pylintrc 关掉非关键项（如 missing-docstring）
用 flake8：轻量、快、聚焦风格和语法错误（比如缩进、空格、未定义变量）；适合刚起步或想先统一格式的团队；配合 black + isort 效果更稳
别混用：VSCode 不支持同时开启 python.linting.pylintEnabled 和 python.linting.flake8Enabled，否则其中一个会被静默忽略

默认 linting 是“打开文件时检查一次”，不是流式检测。要实现实时波浪线，必须靠 Pylance 的类型检查能力补位，而不是只靠 linter。

确保 python.analysis.typeCheckingMode 设为 basic 或 strict（不能是 off），这是 Pylance 提供实时类型提示的基础
python.linting.lintOnSave 控制是否保存时运行 linter，默认是 true；但它不影响编辑过程中的提示——那是 Pylance 干的活
如果你只依赖 pylint，那它永远只在保存后触发；想边写边看，就得靠 python.analysis.typeCheckingMode + Pylance，再加 mypy（可选）做双重覆盖

现代 Python 项目推荐用 pyproject.toml 统一配置，但 VSCode 不会自动识别所有字段，每个工具得单独告诉它“去哪读配置”。

flake8：需在 settings.json 中显式指定 python.linting.flake8Args，例如 ["--config=${workspaceFolder}/pyproject.toml"]
black 和 isort：同样要配 black-formatter.args 和 isort.args，指向同一个 pyproject.toml
mypy：不认 pyproject.toml 里的 [tool.mypy] 段，得用 mypy.ini 或命令行参数；VSCode 中通过 python.linting.mypyArgs 传参（如 --strict）
pylint：不原生支持 pyproject.toml，仍需 .pylintrc；放项目根目录即可，VSCode 会按目录层级向上查找