官方網站
Git 儲存庫產品說明
TheFuck 是一款既幽默又極具實用價值的開源命令列工具，專門用來修正你在終端機中輸入錯誤的指令。相信每一位開發者都遇過這樣的窘境：輸入了一串長長的指令後按下 Enter，卻因為漏掉了 sudo、拼錯了參數，或是忘記切換分支而得到錯誤訊息。這時候，你只需要在終端機輸入 fuck，它就會自動分析上一條出錯的指令，並給出修正後的建議。
它內建了數百種規則（Rules），涵蓋了常見的 Git 操作、套件管理工具（如 apt, brew, npm）、以及基礎的 Shell 指令。它不僅能修復簡單的拼寫錯誤，還能根據錯誤訊息提供「智慧型」的修正，例如：當你試圖推送到不存在的遠端分支時，它會建議你先建立該分支。
核心特色：
- 智慧分析：不只是比對字串，還會根據上一條指令的錯誤代碼與輸出內容來判斷最可能的修正方案。
- 廣泛相容：支援多種 Shell 環境，包括 Bash、Zsh、Fish、PowerShell 以及 macOS 和 Linux 平台。
- 可擴充性強：使用者可以根據自己的工作流程，輕鬆撰寫自訂的修正規則。
- 互動式介面：輸入
fuck後，可以使用方向鍵在多個建議方案中進行選取，確認後按下 Enter 即可執行。 - 社群驅動：擁有龐大的開源社群維護，規則庫持續更新，支援幾乎所有主流的開發工具。
常用指令與操作
TheFuck 的魅力在於它幾乎不需要學習成本，只需在你感到挫折時「抒發情緒」即可。
基礎操作
- 安裝後初始化：安裝完畢後，需在你的
.bashrc或.zshrc中加入eval $(thefuck --alias)。 - 執行修正：當你輸入
puthon卻得到command not found時，緊接著輸入：fuck系統會顯示
python [enter/ctrl+c]，按下 Enter 即可執行正確指令。 - 多方案選擇：若存在多種可能的修正，使用 上下方向鍵 切換建議，Enter 確認執行，Ctrl+C 取消。
常見修正情境範例
| 原始錯誤指令 | 輸入 fuck 後的修正建議 | 修正邏輯 |
|---|---|---|
apt-get install vim | sudo apt-get install vim | 自動補上缺失的權限 |
git brnch | git branch | 修正單字拼寫錯誤 |
git push | git push --set-upstream origin ... | 自動補完遠端分支設定 |
cd Desktop/ (在 macOS) | cd ~/Desktop/ | 修正路徑錯誤 |
python main.py | python3 main.py | 依據環境建議正確的執行檔名稱 |
進階技巧
- 自訂別名：如果你在正式辦公場合不方便輸入
fuck，你可以在設定檔中將別名改為please或fix：eval $(thefuck --alias please) - 規則自訂：你可以進入
~/.config/thefuck/rules目錄下建立 Python 腳本，定義專屬的match與get_new_command邏輯。 - 無聲模式：如果你不希望每次都彈出確認，可以設定
require_confirmation = False，讓它直接執行最可能的修正建議（需謹慎使用）。
操作介面
