VSCode配置PEP8校验需确保flake8或pylint真正运行并与编辑器行为对齐，关键在于启用linter、匹配Python解释器路径、开启保存时检查、统一用pyproject.toml管理规则、正确配置格式化参数及明确配置优先级。
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。
SkillSub Pro - Python 题解与代码注释双功能技能功能概述SkillSub Pro - Python 题解与代码注释双功能技能是一项面向实际任务的技能，主要用于SkillSub Pro 是一个 Python 题解生成与代码注释的 双功能合体技能 ，专为学生、算法学习者和开发者设计；✅ 一个技能，两种用途 ：；核心要点📝 题解模式 ：输入题目/题号，自动生成完整 Python 题解（含详细注释、解题思路、复杂度分析）；💬 注释模式 ：输入 Python 代码，自动添加详细中。它将相关步骤、
立即学习“Python免费学习笔记（深入）”；
- 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）会导致重复报错，选一个主力即可
真正卡住人的，往往不是不会配，而是不知道哪一层配置被哪一层覆盖了，或者pyproject.toml明明写了却放错了位置。动手前先确认工作区根目录、解释器路径、启用开关这三点，比反复调参数更省时间。
