使用需求
受支援的 Windows、macOS 或 Linux 終端機、符合平台的官方套件和待檢查 Python 原始檔。透過 pip 安裝需要受支援的 Python 環境，也可選官方獨立發行套件。
快速開始
2026 年 10 月 29 日核驗的穩定版為 10 月 27 日發布的 0.17.3。按官方安裝指南或發行頁選擇符合平台的套件；受支援的 Python 環境可用 python -m pip install ruff==0.17.3。先執行 ruff check --no-fix --no-fix-only path/to/code 和 ruff format --check path/to/code。這兩種模式不改寫被檢查的原始檔，但 Ruff 仍可能寫入快取。Boloop 本次未安裝或執行此版本。
整合 Python 靜態檢查與格式化的工具。先查看診斷和格式差異，再審查自動修正，避免把靜態檢查通過等同業務正確。
先看檢查結果，再決定是否改寫
Ruff 將 Python 靜態檢查與格式化放在同一工具中。修改程式碼後，可先用 ruff check --no-fix --no-fix-only 查看已啟用規則的診斷，再用 ruff format --check 判斷格式是否需要變化。後者不改寫原始檔，與會原地格式化的 ruff format 不同。
讓規則和修正保持可審查
明確選擇適合專案的規則，不把所有可用規則都當作必要標準。自動修正仍是一份程式碼改動，應查看差異。issue 29682 中，patrick-5546 回報 Ruff 0.17.2 的 PT009 轉換會把正規表示式斷言改為 re.search，卻沒有補上 import re；貢獻者認可該回報。截至 2026 年 10 月 29 日，該問題仍開放，本站未確認 0.17.3 已修正。它針對某項轉換，不代表所有靜態檢查都會出錯。
補上行為證據
lint 通過不能證明使用者流程和失敗復原可用。可結合相關測試及AI 生成程式碼驗收清單，分別記錄靜態問題與實際行為。本推薦依據官方文件和署名回饋，Boloop 本次沒有執行或測量 Ruff 的效能。
資料來源與延伸閱讀
- Ruff official project官方資料 · Astral / Ruff contributors
- Ruff installation官方資料 · Astral / Ruff contributors
- Formatter check versus in-place formatting官方資料 · Astral / Ruff contributors
- Ruff 0.17.3 release官方資料 · Astral / Ruff contributors
- PT009 missing import re #29682使用紀錄 · patrick-5546; ntBre