Ruff 0.16:Python 工具链从“快”走向“默认更严格”

导语

Astral 发布了 Ruff v0.16.0，这是一次比版本号看起来更重要的更新。Ruff 过去以“用 Rust 写的超快 Python linter 与 formatter”出圈，目标是替代 Black、Flake8 及其插件、isort、pydocstyle、pyupgrade 等一组分散工具。0.16 的核心变化，是默认启用规则从 59 条大幅增加到 413 条，让更多严重问题在零配置场景下就能被发现。

核心内容

这次升级的最大看点是默认规则集重构。Ruff 上一次调整默认规则还是 v0.1.0，当时项目总规则数约 708 条；如今规则数已增长到 968 条。过去许多能捕获语法错误、直接运行时错误或现代化迁移问题的规则并未默认开启，导致新用户若不主动研究 `select` 或 `extend-select` 配置，就无法享受到 Ruff 的完整价值。v0.16 将默认规则扩展到 413 条，覆盖更多来自 `flake8-bugbear`、`pyupgrade` 以及 Ruff 自有 `RUF` 分类的检查。对希望维持旧行为的团队，官方也给出退路：在配置中选择 `E4`、`E7`、`E9`、`F`，即可基本回到旧默认集合。
功能层面，Ruff 现在可以格式化 Markdown 中的 Python 代码块。只要 fenced code block 标注为 `python`、`py`、`python3`、`py3`、`pyi` 或 `pycon`，`ruff format` 就能识别并整理；`pyi` 会按 stub 文件处理，`pycon` 会按 REPL 会话处理。它还兼容 Quarto 文档里的 `{python}` 写法，适合把 README、教程、Notebook 风格文档里的示例代码一起纳入质量控制。
另一个重要变化是新的 `ruff: ignore` 抑制注释。它既可像 `noqa` 一样压制同一行诊断，也可单独放在上一行，作用于下一条逻辑语句；`ruff: file-ignore` 则面向整个文件。团队还能写入原因说明，未来阅读时能知道“为什么忽略”，而不是只留下一个神秘例外。配合新的 `--add-ignore` 参数，Ruff 可以自动补充忽略注释；在 preview 模式中，还支持用规则名称替代规则代码。
输出体验也在增强：`check` 与 `format --check` 现在会在诊断里直接展示可修复 diff，不再需要单独运行 `--diff` 才能看到修改内容。`format --check` 还支持和 linter 一致的输出格式，包括 JSON 以及适配 GitHub、GitLab CI 注释的格式。需要注意的是，v0.16 对 JSON 输出有一个小的破坏性调整：部分位置字段现在可能是 `null`，而不是空字符串或默认的第 1 行第 1 列。

深度解读

Ruff 0.16 的意义不只是“规则更多”。它代表 Python 工具链正在从“把很多工具拼起来”转向“一个高性能入口承担默认治理”。HN 评论区的争论也很典型：有人担心 linter 变成审美机器，把精力浪费在格式与风格；也有人认为正是默认工具消灭了 PR 里的无休止争论，让团队把注意力放回产品与真实缺陷。
真正的分水岭在“默认值”。大多数团队不会为每条规则做长期治理，默认配置往往就是实际标准。Ruff 扩大默认规则集，相当于把 Python 社区对常见错误、现代写法和安全边界的共识前移到工具安装后的第一刻。尤其在 AI 编程越来越普遍的背景下，代理生成代码速度快、数量大，强静态检查能成为一种自动化护栏：它不能替代设计审查，但能批量拦下低级错误、过时写法和不一致输出。
同时，Ruff 也在补齐“工程系统”能力。Markdown 代码块格式化意味着文档示例不再是质量盲区；更细粒度的忽略注释让规则例外可审计；CI 友好的输出格式则降低了平台集成成本。这些都说明 Ruff 不再只是开发者本地命令，而是在向团队级、流水线级基础设施演进。

启示与展望

对 Python 项目维护者来说，升级 v0.16 值得优先在 CI 或预提交流程中试跑。最稳妥的方式是先观察新增默认规则带来的告警，区分真实缺陷、可自动修复项和团队暂时不接受的风格规则，再决定是否回退到旧规则集或显式配置选择范围。
更长期看，Ruff 的路线会继续推动 Python 生态整合。过去项目常在 Black、Flake8 插件、isort、pyupgrade、pydocstyle 之间做取舍；现在越来越多场景可以由一个速度足够快、规则覆盖足够广、默认值越来越有主张的工具承担。工具越强，团队越需要把“何时信任默认值、何时保留例外”说清楚。Ruff 0.16 给出的信号是：Python 代码质量治理正在进入更严格、更自动化，也更依赖统一工具链的阶段。