Flake8在VSCode不报错主因是路径未正确配置、lintOnSave未启用或配置文件位置不当；需确认flake8路径、设置python.linting.flake8Path和python.linting.lintOnSave为true，并将pyproject.toml置于工作区根目录。
Flake8 在 VSCode 里不报错，基本就是路径没对上、lintOnSave 关着、或者配置文件放错了位置。
确认 flake8 命令行可用，且路径能被 VSCode 找到
VSCode 的 Python 扩展不会自己装 flake8，它只调用你系统里已有的可执行文件。如果 flake8 装在虚拟环境里，但 VSCode 没激活那个环境，就根本找不到。
- 先在终端运行
which flake8（macOS/Linux）或where flake8（Windows），确认输出是有效路径，比如/Users/you/.venv/bin/flake8或C:\Users\you\venv\Scripts\flake8.exe - 如果没输出，说明没装，或装了但不在当前 shell 的
PATH里：运行pip install flake8（推荐在项目虚拟环境中装） - 在 VSCode 设置中搜索
python.linting.flake8Path，填入上面查到的完整绝对路径——别用~，别用相对路径，必须是全路径 - 不用
pip install --user flake8，某些系统下 VSCode 识别不了--user安装的位置
打开 lintOnSave 和整体 linting 开关
默认情况下，VSCode 只在打开文件时检查一次，改完保存并不会自动标错。这个行为不是默认开启的，得手动开。
- 搜索
python.linting.enabled，确保为true - 搜索
python.linting.flake8Enabled，也设为true - 关键一步：搜索
python.linting.lintOnSave，设为true——这才是“保存即报错”的开关 - 改完设置后，不用重启 VSCode，但要关闭再重新打开一个
.py文件，才能触发新配置
把 pyproject.toml 放对位置，并写对格式
VSCode 会自动读取项目根目录下的 pyproject.toml，但只认这个位置；放在子目录或用 .flake8 文件也行，但优先级低、格式不同，容易出错。
立即学习“Python免费学习笔记（深入）”；
- 文件必须放在工作区（workspace）根目录，不是某个子文件夹里
- 内容示例（注意段落名和缩进）：
[tool.flake8] max-line-length = 99 ignore = "E203, W503" select = "C,E,F,W,B,B950"
- 如果只想禁用某一行的
E501，在该行末尾加# noqa: E501；想整个文件忽略，加# flake8: noqa: E501在文件顶部（注意不是# noqa） - 改完
pyproject.toml后，同样要关闭再重开一个.py文件，VSCode 不会热重载配置
为什么有些错误就是不显示，比如未使用的导入（F401）
flake8 默认只启用核心规则，像 F401（未使用导入）、F841（未使用变量）这些属于 pyflakes 引擎的检查项，需要显式启用。
- 不要在
settings.json里乱加python.linting.flake8Args，容易覆盖默认行为 - 统一在
pyproject.toml里控制：select字段列出你想开的类别，比如"C,E,F,W,B,B950"（F就包含所有pyflakes规则） - 如果用了
ignore但没写全，比如漏了F，那F401就永远不会出现 - 检查右下角 Python 解释器是否和装
flake8的环境一致——VSCode 右下角点一下就能切换
最常被跳过的是这三件事：确认 flake8 真的能在终端跑出版本号、把 python.linting.lintOnSave 设为 true、把 pyproject.toml 放在根目录且改完后重开文件。少一个，就安静得像没装过。
