Python静态代码分析工具ruff

大家好，欢迎来到IT知识分享网。

Ruff 是一个用 Rust 编写的高性能 Python 代码分析工具（Linter），近年来在 Python 生态中迅速流行，并被许多知名项目（如 FastAPI、Pandas、HTTPX 等）采用。

Ruff

与传统工具相比，其最大优势在于速度与功能集成：相较于 Pylint、Flake8 等仅聚焦代码检查的 Linter，Ruff 执行速度快 10-100 倍，内置 500+ 规则并支持自动修复；相比 Black 等单一格式化工具，Ruff 的格式化速度快约 30 倍，且整合了代码检查、格式化和 import 排序（类似 isort）功能，可替代 Flake8+isort+Black 等多工具组合，但暂不支持插件扩展，而传统工具则具备更强的定制性。

对CPython运行的性能比较

项目简史

Ruff 由开发者 Charlie Marsh 于 2022 年 8 月正式开源，其旨在化解传统 Python Linter（诸如 Flake8、Pylint 等）性能欠佳的难题。它依托 Rust 语言进行开发，借助 RustPython 的高性能 AST 解析器以及 Maturin 的打包工具，达成了相较传统工具快 10 至 100 倍的代码分析速率。在此阶段，Ruff 着重于整合 Flake8、isort 等工具的规则集，并支持自动修复功能，旋即吸引了开发者社区的瞩目。

2023 年堪称 Ruff 的爆发之期。4 月，HTTPX 和 Starlette 等声名远扬的项目宣称全面采用 Ruff 以取代 Flake8 和 isort，引发了社区内的广泛热议。其后，Pandas、FastAPI、Airflow 等头部开源项目亦纷纷效仿，Ruff 在 GitHub 的 Star 数量一举突破 1 万。同年 4 月，Charlie Marsh 创立 Astral 公司，斩获 400 万美元种子资金，致力于拓展 Ruff 的功能并开发更多高性能的 Python 工具（例如后续的 uv 包管理器），同时维系 Ruff 的开源且免费之态。

Astral

2024 年至 2025 年，Ruff 持之以恒地优化性能并拓展功能。与此同时，Ruff 逐步实现了代码格式化（类似于 Black）和 import 排序（类似于 isort）功能的集成，由单一的 Linter 演变为多合一的工具，降低了开发者对于多个工具的依赖程度。尽管存在诸如不支持插件、调试门槛较高等局限，然而其规则覆盖率已然超过 500 条，并且支持主流编辑器以及 pyproject.toml 配置，已然成为现代 Python 项目的标准配置工具。

Ruff 的成功推动了 Rust 与 Python 生态的深度融合，其创始人计划开发高性能类型检查工具，可能挑战 Mypy 等现有方案。Astral 公司的成立标志着 Ruff 从社区项目向商业化工具链的转型，目标是通过开源与商业服务的结合，持续提升 Python 开发效率。

安装使用

pip install ruff # 或者按官方推荐的，使用uv安装 uv pip install --upgrade ruff

常用命令

ruff check . # 检查代码 ruff check --fix . # 自动修复 ruff format . # 格式化代码

常用配置

pyproject.toml 示例：

[tool.ruff] # 基础规则集 select = ["E", "F", "I"] # 启用 flake8-error(E)、flake8-fix(F)、isort(I) 规则 ignore = ["E501"] # 忽略行长度检查 # 格式化配置 line-length = 120 # 配合 Black 风格 target-version = "py311" # Python 目标版本 # import 排序配置 [tool.ruff.isort] known-first-party = ["myapp"] # 将本地模块分组到首位

.ruff.toml 示例：

# 独立文件配置 select = ["ALL"] # 启用所有规则（谨慎使用） extend-ignore = ["D203"] # 忽略特定 pydocstyle 规则 # 性能优化 cache-dir = ".cache/ruff" # 指定缓存目录 # 自动修复 fix = true # 检查时自动修复

Ruff 会按【.ruff.toml】 → 【pyproject.toml】 → 【默认配置】的顺序读取，前者覆盖后者。希望完全独立管理 Ruff 配置时，使用 .ruff.toml ；如果需要和其它Linter以及项目配置，统一管理，则使用 pyproject.toml 。

更多配置，可以查看官方文档：Configuring Ruff | Ruff