性能最快的代碼分析工具，Ruff 正在席卷 Python 圈！

幾天前，Python 開源社區又出了一個不小的新聞：HTTPX 和 Starlette 在同一天將在用的代碼分析工具（flake8、autoflake 和 isort）統一替換成了 Ruff，

HTTPX 是一個支持異步的 HTTP 客戶端，Starlette 是一個輕量級的 ASGI 框架，它們都是 Python 社區里的明星專案，目前加起來有近 20K star，它們都選擇了使用 Ruff，再次擴大了 Ruff 的應用版圖，

Ruff 是個誕生僅僅 8 個月的新興專案，但已呈現出一種席卷 Python 社區的趨勢！很多知名的開源專案已采納 Ruff，比如 Transformers、Pandas、FastAPI、Airflow、SciPy、Bokeh、Jupyter、LangChain、PaddlePaddle、Sphinx、Pydantic、LlamaIndex……

Ruff 是什么？為什么它能吸引大量的開源專案使用？相比于其它代碼分析工具，它有哪些突出之處，是否還有一些局限性？現在是否值得將專案在用的工具都替換成它呢？

帶著這些問題，本文將帶你全方位了解這個火爆的專案，

Ruff 加速 Rust 與 Python 的融合

Ruff 誕生于 2022 年 8 月，它是一個用 Rust 語言撰寫的高性能的 Python 靜態代碼分析工具，比其它分析工具快幾個數量級（10-100 倍），而且功能也很全面，

代碼分析工具 即 Linter，用于檢查代碼中的語法錯誤、編碼規范問題、潛在的邏輯問題和代碼質量問題等，可以提供實時反饋和自動修復建議，

在 Ruff 出現之前，社區里的代碼分析工具呈現出百花齊放之勢，比如有 Pylint、Flake8、Autoflake、Pyflakes、Pycodestyle 等等，它們的共同點是都使用 Python 撰寫而成，

Ruff 異軍突起，在性能方面立于不敗之地，主要得益于 Rust 天然的速度優勢，Ruff 的出現，就像基于大語言模型的 ChatGPT 橫空出世，所有競爭對手瞬間就黯淡失色了，

兩個月前，我翻譯了一篇《Python 2023 年的 3 個趨勢》，它預測的第一個趨勢就是 Rust 將加快融入到 Python 相關的專案和工具中，舉出的例子就有 Ruff，

我現在可以補充一個觀察了：用 Rust 開發的新工具將淘汰用其它語言開發的工具，而且新工具的普及速度可能比你的預想快得多！

Ruff 專案的成功，將刺激出更多 Python+Rust 的專案，它的作者 Charlie Marsh 立志于給 Python 構建高性能的開發工具，巧合的是我曾翻譯過他寫的《Using Mypy in production at Spring》，這篇文章恰好發布于 Ruff 誕生的 2022 年 8 月！

因此，我有理由推測：在 Ruff 專案成熟后，他將用 Rust 開發高性能的 Python 型別檢查工具，到時候，目前流行的 Mypy、Pytype、Pyright 和 Pyre 等工具將迎來一大勁敵，（題外話：Python 社區紛亂繁多的虛擬環境管理工具和依賴包管理工具，也有望迎來變革了吧！）

這里還必須介紹兩個 Rust 專案，因為 Ruff 的成功離不開它們：

• RustPython ：用 Rust 寫成的 Python 解釋器，Ruff 利用了它高性能的 AST 決議器，以此實作了自己的 AST 遍歷、訪問器抽象和代碼質量檢測邏輯
• Maturin ：用 Rust 寫成的打包工具，可以將 Rust 專案打包成 Python 可用的包，從而可以被我們“pip install”后使用，且不需要配置 Rust 環境

Ruff 的優點與局限性

介紹完最關鍵的特性后（速度極快、支持 pip），我們接下來看看 Ruff 的其它方面，

總體而言，它具有這些特點：

• 支持 pyproject.toml
• 兼容 Python 3.11
• 超過 500 條內置規則，與 Flake8 內置的規則集近乎對等
• 重新實作了數十個 Flake8 插件，如 flake8-bugbear、flake8-comprehensions 等
• 支持自動修復，可自動糾正錯誤（例如，洗掉未使用的匯入）
• 內置快取，可避免重復分析未更改的檔案
• 支持 VS Code、Pycharm、Neovim、Sublime Text、Emacs 等編輯器
• 對 monorepo 友好，具有分層和級聯配置

首先最值得介紹的是它支持的規則，Ruff 借鑒了流行的工具如 Flake8、autoflake、isort、pyupgrade、yesqa 等等，然后用 Rust 重新實作了超過 500 條規則，它本身不支持插件，但是吸收了數十個常用的 Flake8 插件的設計，使得已囊括的規則范圍比其它任何工具都大，

Ruff 的作者還非常熟悉其它語言的分析工具，比如 Rust 的 Clippy 和 JavaScript 的 ESLint，并從這些專案上得到了設計上的啟發，

Ruff 站在了多個工具/插件的肩膀上，重新實作了它們驗證過的規則，也借鑒了它們的 API 和實作細節，這使得它扮演了一種“集大成”的角色，很方便使用者們作工具的順滑遷移，

Ruff 第二個值得介紹的特點是，它沒有局限于 Linter 的定位，而是借鑒 Rome、Prettier 和 Black 這些代碼格式化工具（Formatter），也實作了代碼格式化的功能，借鑒了 Autoflake、ESLint、Fixit 等工具，實作了代碼自動糾錯的功能，另外，它還借鑒了使用很廣泛的 isort，支持對 import 作快速排序，

這些表明作者的目標并不只是開發一款優秀的代碼分析工具，而是在靜態代碼分析的核心功能外，要創造出更多的可能性，此舉是開發者的福音啊，以后一個工具就能滿足多種訴求，再也不必糾結于不同工具的選型、協作與維護了！

Ruff 還有其它的優點，例如支持 pyproject.toml 、支持 Python 3.11、支持只分析變更的檔案，等等，另外，它也有著一些局限性：

• 支持的 lint 規則還有不夠
• 不支持使用插件，擴展性不強
• 用 Rust 開發的，因此不便于在出錯時 debug，也不便于 Python 開發者給它貢獻代碼

關于第一點，畢竟 Ruff 只是 8 個月大的新生專案，支持更多的規則，只是時間問題，至于插件帶來的擴展性和編程語言的開發者生態，原因也是 Rust，屬于“有得必有失”了，

Ruff 的使用

介紹完 Ruff 的整體情況后，我們接著看看該如何使用它吧，

首先是安裝，可以用 Conda 和其它包管理工具，也可以直接用 pip：

pip install ruff

可以通過以下命令運行：

ruff check .                        # 分析當前及子目錄內的所有檔案
ruff check path/to/code/            # 分析指定目錄及子目錄內的所有檔案
ruff check path/to/code/*.py        # 分析指定目錄內的所有py檔案
ruff check path/to/code/to/file.py  # 分析 file.py

可以用作預提交的鉤子：

- repo: https://github.com/charliermarsh/ruff-pre-commit
  # Ruff version.
  rev: 'v0.0.261'
  hooks:
    - id: ruff

可以通過 pyproject.toml ，ruff.toml 或 .ruff.toml 檔案進行配置，默認配置已能滿足基本使用，詳細配置可以參見檔案的 Configuration ，

Ruff 提供了官方的 VS Code 插件，可以快速上手：

Ruff 官方沒有提供 Pycharm 的插件，社區中有人發布了一個 Ruff 插件，

另外，它還提供了ruff-lsp ，可以被集成到任何支持 Language Server Protocol 的編輯器中，例如 Neovim、Sublime Text、Emacs 等等，

小結

本文從 HTTPX 和 Starlette 采納 Ruff 的新聞開始，向讀者介紹了這個僅誕生 8 個月卻俘獲了一大批知名開源專案，它最突出的特點是使用 Rust 開發，因此在性能方面遠遠超越同類工具，此外，它借鑒了眾多工具和插件的設計，不僅靜態代碼分析的規則全面，而且還具備代碼格式化、代碼自動糾錯和 import 排序等非其它 linter 所擁有的功能，

Ruff 的成功為 Python 社區提供了一個鮮活的榜樣，可以預見，我們將迎來一波用 Rust 開發的高性能工具，Ruff 的成功，與最近火爆的 ChatGPT 一樣，它們傳遞出了一個“這事兒能成”的信號，從而會引爆一場使用新技術的變革！（非常巧合的是：Rust 1.0 在 2015 年 5 月發布，而 OpenAI 在 2015 年 12 月成立，）

總體而言，Ruff 非常強大，憑實力而風靡 Python 社區，絕對推薦使用！它的使用檔案很友好，如果你想了解更多細節，可以去翻查，

標籤：Python

上一篇：完善版手游導航原始碼app軟體 APP手機軟體 應用商城下載類網站布局規整

下一篇：Django筆記二十之手動撰寫migration檔案