Ruff可完全替代Flake8，需确保ruff命令终端可用、pyproject.toml启用extend-select=["I","D","UP"]、VSCode中配置codeActionsOnSave的source.fixAll和source.organizeImports为"explicit"。
Ruff 在 VSCode 中能完全替代 Flake8，而且默认就支持 # noqa 注释、自动修复、保存即格式化——但前提是本地 Ruff 可执行文件已安装，且 VSCode 配置没绕进几个常见死胡同。
确保 ruff 命令在终端可用
VSCode 的 Ruff 扩展不会自带二进制，它依赖你系统 PATH 里有 ruff 命令。很多人装了扩展却没检查这步，结果 lint 完全不触发。
- 在 VSCode 内置终端运行
ruff --version，必须返回版本号（如ruff 0.5.4），否则扩展会静默失效 - 推荐用
pipx install ruff安装，避免虚拟环境切换时路径丢失；如果用pip install ruff，确保当前 Python 环境与 VSCode 选中的解释器一致 - Windows 用户注意：PowerShell 和 CMD 的 PATH 加载行为不同，建议统一在 VSCode 设置里显式指定
ruff.path
pyproject.toml 规则配置别漏掉 extend-select
Ruff 默认只启用基础规则集（E/F/W），Flake8 常用的导入排序（I）、docstring 检查（D）、语法升级（UP）都得手动打开，否则看起来“不如 Flake8 严”。
- 想完全覆盖 Flake8 + isort + pydocstyle，至少加这三行：
extend-select = ["I", "D", "UP"] -
select和extend-select是并集关系，不是覆盖；ignore对两者都生效 - 行宽设成
line-length = 88才能和 Black 兼容，否则ruff format和ruff check会产生冲突提示
VSCode 设置里必须配对启用 codeActionsOnSave
光开 editor.formatOnSave 只能格式化，不能自动修复 F401（未使用导入）这类问题。Ruff 的“一键修复”能力藏在 codeActionsOnSave 里，且需要精确匹配键名。
提示词大师-python版
下载
图片提示词生成器？不止如此。 马甲系统 —— 把脑海中的画面，翻译成AI能理解的专业表达。 用得越多，它越懂你：首次需要多问几句确认方向，用久了几乎一说就懂。 用得越多，它越快：缓存机制让后续对话越来越省。 RAG进化：成功案例持续入库，越跑越聪明。 输入「新手指南」查看完整功能介绍
立即学习“Python免费学习笔记（深入）”；
- 修复所有可自动修复项：
"source.fixAll": "explicit"（不是true或"all"） - 整理导入（等效 isort）：
"source.organizeImports": "explicit" - 这两项必须写在
"[python]"语言专属设置下，全局设置无效 - 如果同时启用了 Pylint 或其他 linter，记得关掉
python.linting.enabled，否则会冲突报错
# noqa 注释行为和 Flake8 一致，但位置更敏感
# noqa 能照常工作，但 Ruff 对注释位置要求更严格：必须紧贴违规代码行末尾，中间不能有空格或换行，否则忽略失效。
- 正确：
import json # noqa或from psycopg2 import pool # noqa: F401 - 错误：
import json# noqa（无空格）、# noqa单独一行、或写在上一行注释里 - 指定规则时用冒号分隔，如
# noqa: F401, E501；不加规则名则忽略该行所有检查 - VSCode 悬停提示里显示的错误码（如
F401）可直接复制进# noqa:后面，无需查表
最易被忽略的是 ruff 命令的 PATH 可见性——VSCode 启动方式（桌面图标 vs 终端启动）会影响环境变量加载，调试时优先在 VSCode 终端验证命令是否可达，比翻 settings.json 更快定位问题。
