VSCode配置Python项目的PEP8规范校验-VSCode-PHP中文网

VSCode配置PEP8校验需确保flake8或pylint真正运行并与编辑器行为对齐，关键在于启用linter、匹配Python解释器路径、开启保存时检查、统一用pyproject.toml管理规则、正确配置格式化参数及明确配置优先级。

vscode配置python项目的pep8规范校验

VSCode里配PEP8校验，本质不是“装个插件就完事”，而是得让flake8或pylint真正跑起来，并和编辑器行为对齐。否则你看到的波浪线要么没有，要么乱报、报错后格式化又打回原形。

为什么保存后没波浪线？—— linting根本没启动

最常见原因：VSCode压根没启用linter，或者启用了但路径不对、解释器不匹配。

python.linting.enabled 和 python.linting.flake8Enabled（或 python.linting.pylintEnabled）必须同时设为 true，缺一不可
确认左下角Python解释器路径和你终端里 which flake8（macOS/Linux）或 where flake8（Windows）输出一致；不一致就手动在设置里填 python.linting.flake8Path
python.linting.lintOnSave 默认是 false，必须显式设为 true，否则改完保存也不检查
改完设置后不用重启VSCode，但得关掉当前.py文件再重新打开，语言服务器才会读新配置

flake8报E231、W503但black一格式化就红波浪线——规则打架

Black加尾逗号不加空格，flake8的E231却要求逗号后必须有空格，两者硬碰硬只会互相覆盖。

别在settings.json里调python.linting.flake8Args去禁用规则，容易和项目级配置冲突
统一用项目根目录下的pyproject.toml管理flake8规则：
```
[tool.flake8]
ignore = "E231, W503"
select = "C,E,F,W,B"
```
pyproject.toml必须放在VSCode打开的**工作区根目录**（即资源管理器最外层文件夹），放错一层就无效
某行真要跳过检查，写# noqa: E231，不是# noqa或# noqa: black

autopep8格式化后风格不满意——参数没走通或配置被忽略

autopep8默认只修基础PEP8问题，比如E225（运算符缺空格）、E302（类方法间空行数），但E501（行太长）默认不修，除非加--aggressive。

macOS UI 自动化技能包 —— 用 Python 控制你的 Mac

让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限

下载

VSCode里设python.formatting.provider为"autopep8"后，还得配python.formatting.autopep8Args，例如：
```
"python.formatting.autopep8Args": ["--aggressive", "--max-line-length=79"]
```

更稳的做法是项目根目录建setup.cfg：

[flake8]
ignore = E501,W503,E231
max-line-length = 79

如果VSCode总提示“找不到autopep8”，检查是否在正确虚拟环境中安装；路径不对时填绝对路径到python.formatting.autopep8Path
禁用其他格式化插件（如“Auto PEP8”独立扩展、“Python Docstring Generator”），它们会抢在你选的formatter前执行

pyproject.toml和settings.json谁说了算？——优先级和作用域

VSCode的Python插件会按顺序合并配置：项目级pyproject.toml > 工作区.vscode/settings.json > 用户全局设置。但关键在于，pyproject.toml只影响flake8/pylint等工具本身的规则，而settings.json控制VSCode是否启用它们、用哪个可执行文件、何时触发。

pyproject.toml里写的line-length = 88只对black生效；flake8要用[tool.flake8]段
black的--line-length参数必须通过python.formatting.blackArgs传，不能靠pyproject.toml里的[tool.black]自动生效（除非你用的是新版插件+正确版本black）
多个linter同时启用（比如flake8Enabled和pylintEnabled都为true）会导致重复报错，选一个主力即可