官方網站
Git 儲存庫產品說明
Ruff 是一款極其快速的 Python 代碼檢查器（Linter）與格式化器（Formatter），完全使用 Rust 語言編寫。在 Ruff 出現之前，Python 開發者通常需要組合使用 Flake8、isort、Black 等多個工具，而 Ruff 的目標就是「一個抵十個」，並提供快上 10 到 100 倍的驚人效能。
Ruff 內建了超過 700 條檢查規則，幾乎涵蓋了所有主流 Linter 的功能。它不僅能找出代碼中的潛在錯誤（如未使用的變數、錯誤的匯入），還能自動修復（Auto-fix）大部分問題。對於大型專案來說，原本需要跑 10 秒的代碼檢查，在 Ruff 上僅需 0.1 秒，實現了真正的「即時反饋」。
核心特色：
- 無與倫比的效能：利用 Rust 的並行運算能力，大規模專案的檢查也是瞬時完成。
- 全能一體化：單一工具即可取代 Flake8、isort、pydocstyle、yesqa、pyupgrade 等眾多工具。
- 高度相容性：完美支援最新的 Python 語法，並提供對 Black 格式化風格的無縫對接。
- 自動修復功能：支援
fix指令，能自動修正代碼風格問題與刪除多餘的 import。
常用指令
Ruff 的 CLI 設計非常現代化，安裝後即可直接在專案根目錄執行：
核心管理指令
# 檢查目前目錄下的代碼問題
ruff check .
# 檢查並自動修復所有可修復的問題
ruff check --fix .
# 以「觀察模式」執行，檔案存檔時自動重新檢查
ruff check --watch .
# 作為格式化工具使用（取代 Black）
ruff format .
設定與進階技巧
| 指令/操作 | 功能說明 |
|---|---|
ruff rule RUF100 | 快速查看特定錯誤代碼的詳細說明與範例 |
ruff linter --statistics | 統計專案中各種錯誤類型的發生次數 |
| Editor Integration | 支援 VS Code, PyCharm 與 Zed，存檔時瞬間自動格式化 |
在專案中只需一個 pyproject.toml 檔案即可設定 Ruff 的行為：
[tool.ruff]
line-length = 88
select = ["E", "F", "I"] # 選擇檢查規則集
操作介面
