作者：林岚｜OC 技术与安全编辑

Ruff 0.16.0 已发布，默认启用规则从 59 条增加到 413 条，并支持格式化 Markdown 和 Quarto 文档中的 Python 代码块。官方称破坏性变化数量有限，但没有显式配置规则集的项目，升级后可能一次出现大量新诊断。

一句话结论：Ruff 的新默认值能让新项目立即获得更完整检查，对依赖默认配置的旧项目却相当于修改了质量门槛；工具升级本身可能让 CI 从绿色变红。

Ruff 自 v0.1.0 后，内置规则总量已经从 708 增长到 968，但默认集合长期只覆盖少数 Pyflakes 和 pycodestyle 规则。新版加入 flake8-bugbear、pyupgrade 和 Ruff 自有类别中的更多检查，包括语法错误、立即发生的运行时错误和现代 Python 迁移建议。

已经用 select 或 extend-select 固定规则的项目受影响较小。需要保持旧行为的团队，可以显式设置 select = ["E4", "E7", "E9", "F"]。这也说明，生产 CI 不应把第三方工具的“默认值”当成不会变化的接口。

Markdown 格式化会识别标记为 python、py、pyi、pycon 等语言的围栏代码，也支持 Quarto 的 {python}。项目可以使用格式化关闭注释或排除 *.md。这对文档代码同步有帮助，也可能制造大批与功能无关的格式差异。

新版还增加 ruff: ignore 和 ruff: file-ignore 注释，可针对逻辑行或整个文件抑制规则并写明原因。check 和 format --check 默认输出也会显示修复 diff。JSON 输出中的文件名和位置字段现在可能为 null，依赖固定字段的 CI 解析器需要调整。

林岚认为，Ruff 这次升级的风险不在规则变多，而在团队没有声明自己采用哪些规则。最稳妥的方法是先在非阻断任务中运行新版，记录基线，分批修复，再显式固定版本和规则集合。

关键事实

• 来源：Astral Ruff 官方发布说明和格式化文档
• 版本：Ruff 0.16.0
• 默认规则：从 59 条增加至 413 条
• 新能力：Markdown Python 代码块格式化、新抑制注释和更完整 CI 输出

OC 判断

默认值适合新用户，不是稳定的团队契约。任何进入 CI 的 Linter 都应固定版本、规则和升级流程，否则一次依赖更新就可能重写质量标准。

为什么重要

• 对开发者：本地升级前应检查 CI 配置和 Markdown 改动范围。
• 对企业：规则基线应进入仓库，而不是依赖工具当前默认值。
• 对用户：更多规则能减少运行时错误，但必须避免为追求零警告制造无意义修改。

参考来源

• Astral：Ruff v0.16.0
• Ruff Docs：Formatter