VSCode怎么配置Ruff替代Flake8检查_VSCode如何使用Ruff插件快速检查Python代码规范【指南】-VSCode-PHP中文网

ruff在vscode中不报错的根本原因是未被正确识别为linter或配置未生效：需安装官方插件、禁用其他linter、显式启用ruffenabled、确保ruff.toml位于工作区根目录并重启窗口。

vscode怎么配置ruff替代flake8检查_vscode如何使用ruff插件快速检查python代码规范【指南】

根本原因通常是 ruff 没被正确识别为格式化/检查工具，或者 VSCode 仍默认走 flake8 或 pylint 的旧配置。Ruff 默认只在保存时触发检查（且需开启），而很多人装完插件就以为自动工作了。

确认已安装官方插件：Ruff（作者：charliermarsh.ruff-vscode），不是第三方“Ruff Linter”之类老版本
关闭其他 Python linter 插件（如 ms-python.flake8、ms-python.pylint），它们会抢占 python.defaultLinter 控制权

在用户或工作区设置中显式启用 Ruff：

"python.linting.enabled": true,<br>"python.linting.ruffEnabled": true

如果用的是 Pylance（微软官方语言服务器），它默认禁用外部 linter；需加
```
"python.analysis.extraPaths": []
```
并确保 ruff 在 $PATH 中可执行（终端里能直接运行 ruff --version）

Ruff 插件默认只读当前打开文件所在目录或其父级中的 ruff.toml（或 pyproject.toml 里的 [tool.ruff]），不会跨项目根目录查找。常见坑是把配置放错位置，或 VSCode 打开的不是项目根目录。

Ruff 的自动修复能力依赖于 VSCode 的 “format on save” 和 “code action on save”，但默认只对格式化生效，不自动触发修复。而且 ruff --fix 有安全边界：它只修无歧义的规则（如缩进、空行），不碰语义类问题（如未使用变量）。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

启用保存时修复需两项配置同时存在：

"editor.formatOnSave": true,<br>"python.formatting.provider": "ruff"

若只想修 lint 错误（非格式），得手动调出「快速修复」（Ctrl+. / Cmd+.），或配置：
```
"editor.codeActionsOnSave": {<br>  "source.fixAll.ruff": true<br>}
```
ruff --fix 不支持所有规则，比如 F841（未使用变量）默认不自动删，得加
```
extend-fixable = ["F841"]
```
到 ruff.toml
修复失败时看 VSCode 输出面板 → 选择 Ruff，常见错误如 error: Failed to parse ...，说明文件语法有硬错误，Ruff 直接跳过

Ruff 插件默认走系统 $PATH，不自动感知项目虚拟环境。当项目用 poetry 或 venv 管理依赖时，VSCode 可能仍在用全局旧版 ruff，导致规则不一致甚至报错。