VS Code 的 Ruff 扩展默认会优先使用 ruff.format.args 中指定的命令行参数（如 --line-length=79），从而覆盖项目根目录下的 ruff.toml 配置；解决方法是移除冲突参数、显式指定配置路径，或启用原生 Rust 服务器。
vs code 的 ruff 扩展默认会优先使用 `ruff.format.args` 中指定的命令行参数（如 `--line-length=79`），从而覆盖项目根目录下的 `ruff.toml` 配置；解决方法是移除冲突参数、显式指定配置路径，或启用原生 rust 服务器。
在 VS Code 中集成 Ruff 进行代码格式化时，一个常见误区是误以为只要设置了 "ruff.configurationPreference": "filesystemFirst"，扩展就会自动加载项目中的 ruff.toml 文件——但实际上，该设置仅影响 Ruff 的 linting（检查）行为，对 formatting（格式化）无效。格式化功能由 ruff format 命令驱动，而 VS Code Ruff 扩展默认通过 ruff.format.args 向该命令传递显式参数，这些参数会强制覆盖 ruff.toml 中的配置。
例如，您当前的配置：
"ruff.format.args": ["--line-length=79"]
等价于在终端执行：
ruff format --line-length=79 # ⚠️ 此参数将无视 ruff.toml 中的 line-length 设置
✅ 正确解决方案（三选一）
方案 1：彻底移除 ruff.format.args（推荐）
若项目已通过 ruff.toml 统一管理格式规则，最简洁的做法是删除该配置项：
// settings.json（工作区或用户设置）
{
"ruff.configurationPreference": "filesystemFirst",
"editor.defaultFormatter": "charliermarsh.ruff",
"notebook.defaultFormatter": "charliermarsh.ruff"
// ❌ 删除 "ruff.format.args" 整行
}
此时 Ruff 扩展将自动探测并加载项目根目录下的 ruff.toml（或 .ruff.toml），完全遵循文件配置。
方案 2：显式指定配置文件路径
若需保留 ruff.format.args（如用于其他定制），请改用 --config 参数指向配置文件：
使用ydata-profiling（前身为pandas-profiling）生成全面的数据质量报告，包含相关性分析、缺失值模式和基数检测。导出交互式HTML仪表板和JSON摘要。
"ruff.format.args": ["--config=./ruff.toml"]
⚠️ 注意：路径为相对于工作区根目录的相对路径，且必须使用 ./ 开头以确保被正确识别。
方案 3：启用原生格式化服务器（推荐用于新项目）
自 Ruff v0.5+ 起，扩展支持基于 Rust 的原生语言服务器（Native Server），它原生支持 ruff.toml 配置，无需额外参数：
"ruff.nativeServer": "on"
启用后，格式化、Linting 均统一受 ruff.toml 控制，性能更高且行为更一致。
? 验证是否生效
- 保存
settings.json并重启 VS Code； - 在 Python 文件中触发格式化（
Ctrl+Shift+I或右键 → Format Document）； - 检查实际换行效果是否符合
ruff.toml中定义的line-length（如line-length = 90）； - 可在 VS Code 输出面板（
View → Output→ 选择Ruff）中查看日志，确认加载的配置路径。
? 重要提醒：
ruff.configurationPreference对格式化无影响，仅作用于 Linting；ruff.lint.args同理可能干扰检查规则，建议同步清理或改用--config。始终优先依赖ruff.toml实现团队配置标准化，避免 VS Code 设置与配置文件不一致引发协作问题。
