基本用法

相关源文件

• README.md
• setup.py
• tests/test_ui.py
• thefuck/logs.py
• thefuck/ui.py

本页面将介绍安装后的 TheFuck 用法。它涵盖了有效修正 Shell 命令所需的关键命令、工作流程和选项。有关安装说明，请参阅安装。

设置别名

在使用 TheFuck 之前，您需要在您的 Shell 配置文件中设置别名。

将此添加到您的 .bashrc、.zshrc 或其他 Shell 配置文件，然后使用 source ~/.bashrc (或您 Shell 的等效命令) 重载您的 Shell。

来源： README.md153-166

基本工作流程

典型的使用工作流程包括以下步骤：

1. 您输入一个导致错误的命令。
2. 您运行 fuck (或您的自定义别名)。
3. TheFuck 会建议一个修正后的命令。
4. 您确认或从多个建议中选择。
5. 修正后的命令将被执行。

图示：基本命令修正流程

来源： README.md14-77 thefuck/ui.py59-96

命令选择

当有多个修正建议可用时，您可以通过以下方式在它们之间导航：

• ↑ 或 k：选择上一个建议
• ↓ 或 j：选择下一个建议
• Enter：执行选中的建议
• Ctrl+C 或 q：中止，不执行

图示：命令选择界面

来源： thefuck/ui.py11-25 thefuck/ui.py59-96 tests/test_ui.py19-37

命令选项

TheFuck 为不同的使用场景提供了几个命令行选项。

选项	短期	描述
--yeah	-y	无确认运行已修复的命令。
--hard		等同于 --yeah (替代语法)。
--recursive	-r	递归修复命令，直到成功
--require-confirmation		即使在设置中禁用了确认，也强制确认。
--no-color		禁用彩色输出
--debug		启用调试输出
--alias		打印 Shell 的别名命令。

使用示例

来源： README.md167-178

视觉反馈

TheFuck 在建议修正时提供视觉反馈。

• 具有副作用的命令会标记为 (+side effect)。
• 当需要确认时，界面会显示 [enter/↑/↓/ctrl+c]。
• 当找不到匹配项时，会显示“No fucks given”。

图示：视觉反馈组件

来源： thefuck/logs.py50-77 thefuck/ui.py59-96 tests/test_ui.py65-108

命令修正过程

在后台，TheFuck 会这样处理您的命令：

图示：命令修正管道

来源： thefuck/ui.py27-58 thefuck/ui.py59-96 README.md196-200

示例

这里有一些常见示例，展示了 TheFuck 如何修正命令：

示例 1：缺少 sudo

示例 2：Git 命令修正

示例 3：命令未找到及建议

来源： README.md14-77

禁用确认

如果您希望自动执行修正而不进行确认，

1. 请在您的设置文件（~/.config/thefuck/settings.py）中设置 require_confirmation = False。
2. 或者使用 --yeah 选项：fuck --yeah。

当禁用确认时，TheFuck 将显示修正后的命令并立即执行它。

来源： README.md79-92 thefuck/ui.py77-79

实验性即时模式

为了更快的响应速度，TheFuck 提供了一种实验性的即时模式，该模式通过 script 来记录输出，而不是重新运行命令。

此模式目前仅支持 Python 3 以及 bash 或 zsh。

来源： README.md8 README.md526-543