我們在「【🔒 Python 先修班】⬆️ 培養良好的Coding Style讓專業度 Up!Up!Up!」談到了Coding Style， 在文末也分享了pylint的程式碼檢查工具， 雖然內建、簡單快速上手， 但隨著技術的演進， 我們總需要又快、又好、又簡單的工具做為預設的工具庫， Ruff就是一個新世代的Python Linter工具， 底層由Rust程式語言進行開發， 我們可以看看官方的效能評比報告， 根本就是開跑車啊！！！
什麼是Linter？
它是一種程式碼檢查工具， 幫助我們在開發的過程中檢查出語法錯誤、漏洞…等， 可能危害程式的語法， 就如同我們的編輯器會抱怨出紅字一樣的告警。
目的都是為了自動化的幫我們進行QA， feat.【🔒 Python 先修班】⬆️ 培養良好的Coding Style讓專業度 Up!Up!Up!
安裝無負擔
雖然是rust開發， 但ruff一樣有將工具打包成pypi並上傳至平台(feat.【🔒 Python 先修班】教你親手打包專屬套件庫的手作課(pip install…))， 因此我們也可以輕鬆的進行安裝。
pip install ruff
如果我們不打算安裝， 只想要初淺的玩玩語法檢查， 那可以來這裡 https://play.ruff.rs/ 試玩看看…
基本指令導覽
我們可以對某個python檔案進行檢查
ruff check xxx.py
也可以檢查目錄
ruff check 目錄
當然也可以僅針對某個目錄底下的.py檔案檢查
ruff check 目錄/*.py
修復錯誤可以這樣做:
ruff check --fix .
Found 1 error (1 fixed, 0 remaining).
要怎麼假裝看不見的忽略錯誤？
一切都不是我的錯， 我不想看到錯誤， 我們開發到很煩躁的時候應該都非常想這樣做吧！ 雖然這個作法不太建議啦， 但有時候我們幾乎可以不用理會一些非必要的錯誤時(註解、docstring…)，我們就可以這樣做。
# Ignore F841.
x = 1 # noqa: F841
# Ignore E741 and F841.
i = 1 # noqa: E741, F841
# Ignore _all_ violations.
x = 1 # noqa
當然在docstring也可以如此。
""Lorem ipsum dolor sit amet.
Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor.
""" # noqa
配置檔與規則
我們可以在這裡「settings/#top-level」看到一堆密密麻麻的規則， 當然我們不需要嚴謹的每一條都列上， 這取決於團隊的風格與偏好去進行選擇。
P.S 不論是老牌的pylint到flake8， 各種配置應有盡有， 只是團隊要轉移時需要有一次性的工序， 將原本的配置檔進行轉換一下。
至於檔案的名稱雖然支援了「pyproject.toml」、「ruff.toml」、「.ruff.toml」， 但會比較建議另外的檔案去管理這些規則， 如果都納入「pyproject.toml」， 我們除了安裝的配置也要有Lint的配置， 會稍微混亂一些。
如果還是堅持想要直接在「pyproject.toml」裡面描述的話， 那需要一個區塊來進行區隔。
[tool.ruff]
select = ["E4", "E7", "E9", "F"]
ignore = []
如果是獨立的「.ruff.toml」與「ruff.toml」時， 我們就不需要多一層進行區隔了。
# Enable flake8-bugbear (`B`) rules.
select = ["E", "F", "B"]
# Never enforce `E501` (line length violations).
ignore = ["E501"]
以下是個人習慣的簡易配置。
line-length = 80
[pydocstyle]
convention = "google"
[format]
quote-style = "single"
如何與編輯器vscode整合？
下載Ruff VS Code 擴展，它支援修復操作、導入排序等。
安裝完畢之後， 我們只要在專案目錄底下撰寫.toml配置檔， vscode就能夠根據我們的配置檔幫我們進行程式碼的檢查與格式化了。
我們可以使用Ctrl + Shift + P並設定預設的「文件格式化方式」， 這邊會有三個選項， 我們可以選擇ruff即可(記得重新載入VSCode才會生效唷)。
接下來我們就可以直接對程式碼文件進行Ctrl + Shift + I 就可以幫我們進行排版了。
結合自動化檢核流程讓我們更省事
既然我們已經學會怎麼搭建Linter之後，但會面臨到一個問題，我們通常在開發的過程會使用Git來管理原始碼，如果能夠在提交之前自動幫我們檢查那該有多好啊！ 正好，Python的開發模式也提供了pre-commit套件，它可以在commit之前進行一些前置作業流程，詳細請參考：「【🔒 Python 先修班】🧐 請加入自動化QA(pre-commit)來幫我們檢核程式碼」
結語
我想大家應該都不想在Code Review的時候被排版的問題耗費大量的時間與精力吧！ 而我們也難以人工的去肉眼檢查每一個空格、Tab…等的格式， 這時候就需要有自動化的工具來幫我們完成， 而Ruff是目前用起來效能較佳、功能較完整的一套工具， 不妨試著導入看看， 讓我們的程式碼品質更加精進吧！
您是否苦於網路資訊爆炸嗎？ 教學何其多，但卻無法好好選擇的困境呢？ 歡迎加入「🔒 阿Han的軟體心法實戰營」， 這裡不給您冗餘的雜訊， 單刀直入直接送您重點， 避開選擇障礙的困境， 讓您獲得業界標準的開發起手式， 成為Top 1的頂尖人才。
