The Fuck 命令纠错

The Fuck 是什么

The Fuck 是一款用 Python 编写的终端命令纠错工具。当你在终端里敲错命令、缺少参数或权限不足导致执行失败时，只需输入 fuck，它就会分析上一条命令，匹配内置规则，生成一条修正后的命令供你确认执行。

项目灵感来自一条推文，如今已积累近 10 万 Star，是命令行效率工具中的经典之作。

典型示例

➜ apt-get install vim
E: Could not open lock file /var/lib/dpkg/lock - open (13: Permission denied)

➜ fuck
sudo apt-get install vim [enter/↑/↓/ctrl+c]

➜ puthon
zsh: command not found: puthon

➜ fuck
python [enter/↑/↓/ctrl+c]

➜ git brnch
Did you mean this?
    branch

➜ fuck
git branch [enter/↑/↓/ctrl+c]

工作原理

The Fuck 会把上一条失败命令与一系列规则逐一匹配。命中规则后，它会基于该规则生成新命令并执行。默认启用的规则覆盖了大量高频场景，例如：

• sudo 相关：权限不足时自动补 sudo
• cd_correction：拼写检查并纠正失败的 cd
• cd_mkdir：目录不存在时先创建再进入
• git_* 系列：修正分支、推送、add 等常见 git 错误
• docker_not_command：纠正错误的 docker 子命令
• dry：修复 git git push 这类重复输入

完整规则列表可在项目 README 中查看，也支持编写自定义规则。

安装与配置

macOS / Linux 可通过 Homebrew 安装：

brew install thefuck

Ubuntu / Mint 可用 pip 安装：

sudo apt update
sudo apt install python3-dev python3-pip python3-setuptools
pip3 install thefuck --user

Arch、FreeBSD、ChromeOS 等系统也有对应的包管理器安装方式。

安装后需要在 .bashrc、.zshrc 等启动脚本中加入别名：

eval $(thefuck --alias)
# 也可以自定义别名
eval $(thefuck --alias FUCK)

修改后执行 source ~/.bashrc 使其立即生效。

常用参数

• fuck --yeah（或 -y）：跳过确认，直接执行修正命令
• fuck -r：递归修正，直到命令成功为止

适用人群

适合经常在终端里工作的开发者、运维人员，尤其是频繁使用 git、docker、包管理器的人群。由于会自动执行命令，建议保留默认的确认步骤，避免误执行。