Ubuntu 22.04 中安装 thefuck 与 tldr 工具

Ubuntu 22.04 中安装 thefuck 与 tldr 工具

作为一名经常使用终端的开发者，拥有高效的命令行工具能极大提升工作效率。本文将详细介绍如何在 Ubuntu 22.04 系统上安装和配置两款非常实用的终端工具：thefuck（命令纠错工具）和 tldr（简洁帮助文档工具），并分享安装过程中遇到的问题及解决方案。

1. 工具介绍

1. thefuck：智能命令纠错工具

thefuck 是一款神奇的命令行纠错工具，当你输入错误的命令时，只需输入 fuck，它就能智能分析并纠正你的命令错误。支持纠正拼写错误、权限问题、命令不存在等多种常见错误。

2. tldr：简洁明了的帮助文档

tldr（Too Long; Didn’t Read）是传统 man 命令的替代品，提供简洁明了的命令使用示例，特别适合快速查询命令用法。支持多语言，本文将配置为中文。

2. thefuck 安装与配置

第一步：安装依赖包

首先确保系统已安装必要的 Python 依赖：

1
2
sudo apt update
sudo apt install python3-dev python3-pip python3-setuptools

第二步：安装 thefuck

方法一：使用 pip 安装（推荐）

1
pip3 install thefuck --user

安装完成后，会出现以下警告信息：

1
WARNING: The scripts fuck and thefuck are installed in '/root/.local/bin' which is not on PATH.

这表明安装路径不在系统的 PATH 环境变量中，需要手动添加。

方法二：使用 apt 安装（备选方案）

如果 pip 安装遇到问题，也可以使用系统包管理器安装：

1
sudo apt install thefuck

第三步：配置环境变量和别名

编辑 .bashrc 文件：

1
vim ~/.bashrc

添加以下内容：

1
2
3
4
5
# 添加 thefuck 安装路径到 PATH
export PATH="$HOME/.local/bin:$PATH"

# 配置 thefuck 别名
eval "$(thefuck --alias)"

使配置生效：

1
source ~/.bashrc

第四步：验证安装

测试 thefuck 是否正常工作：

1
2
3
4
5
# 故意输入错误命令
lt

# 使用 fuck 纠正
fuck

正常情况下，thefuck 会智能识别错误并提供修正建议：

1
sudo apt-get install looptools && lt [enter/↑/↓/ctrl+c]

3. tldr 安装与配置（中文版本）

第一步：安装 pipx

tldr 推荐使用 pipx 进行安装，以确保隔离性：

1
2
3
sudo apt update && sudo apt install -y pipx

pipx ensurepath

第二步：安装 tldr

1
pipx install tldr

解决网络超时问题

如果遇到以下超时错误：

1
pip._vendor.urllib3.exceptions.ReadTimeoutError: HTTPSConnectionPool(host='files.pythonhosted.org', port=443): Read timed out.

可以配置 pip 国内镜像源加速下载：

1
2
3
4
5
6
7
8
9
10
mkdir -p ~/.pip
cat > ~/.pip/pip.conf << EOF

[global]
index-url = https://mirrors.aliyun.com/pypi/simple/

[install]
trusted-host = mirrors.aliyun.com

EOF

然后重新安装：

1
2
pipx uninstall tldr
pipx install tldr

第三步：配置中文显示

安装中文语言包

1
sudo apt install -y locales language-pack-zh-hans

配置 locale

运行 locale 配置工具：

1
sudo dpkg-reconfigure locales

在图形界面中：

  1. 找到 zh_CN.UTF-8 UTF-8，按空格键勾选。

  2. 选择 zh_CN.UTF-8 作为默认 locale。

  3. 按 Tab 键切换到 OK，回车确认。

设置环境变量

编辑 .bashrc 文件：

1
vim ~/.bashrc

添加以下内容：

1
2
3
4
# 配置中文环境
export LANGUAGE="zh:en"
export LC_MESSAGES="zh\_CN.UTF-8"
export LC_ALL="zh\_CN.UTF-8"

使配置生效：

1
source ~/.bashrc

第四步：同步 tldr 数据

1
tldr --update

第五步：验证安装

测试 tldr 是否正常工作并显示中文：

1
tldr ls

正常情况下，会显示中文的简洁帮助文档：

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
root@hcss-ecs-be68:~# tldr ls

  ls

  列出目录中的内容。
  更多信息：https://www.gnu.org/software/coreutils/manual/html_node/ls-invocation.html.

  - 列出目录中的文件，每个文件占一行：
    ls -1

  - 列出包含隐藏文件的所有文件：
    ls --all

  - 列出所有文件，如果是目录，则在目录名后面加上「/」：
    ls --classify

  - 列出包含隐藏文件的所有文件信息，包括权限，所有者，大小和修改日期：
    ls --all -l

  - 列出所有文件信息，大小用人类可读的单位表示（KiB, MiB, GiB）：
    ls -l --human-readable

  - 列出所有文件信息，按大小降序排序：
    ls -lSR|-lS --recursive

  - 列出所有文件信息，按修改日期从旧到新排序：
    ls -lt --reverse

  - 只列出目录：
    ls --directory */

4. 常见问题及解决方案

问题一：thefuck 命令找不到

错误信息：

1
Command 'thefuck' not found

解决方案：

确保 /root/.local/bin 已添加到 PATH 环境变量：

1
export PATH="$HOME/.local/bin:$PATH"

问题二：中文 locale 配置错误

错误信息：

1
-bash: warning: setlocale: LC_MESSAGES: cannot change locale (zh_CN.UTF-8): No such file or directory

解决方案：

安装中文语言包并重新配置 locale：

1
2
sudo apt install -y language-pack-zh-hans
sudo dpkg-reconfigure locales

问题三：pipx 安装 tldr 超时

错误信息：

1
ReadTimeoutError: HTTPSConnectionPool(host='files.pythonhosted.org', port=443): Read timed out.

解决方案：

配置 pip 国内镜像源，或使用代理加速下载。

5. 工具使用技巧

1. thefuck 使用技巧

  1. 基本使用：输入错误命令后，直接输入 fuck 即可纠正。

  2. 跳过确认：使用 fuck --yeah 或 fuck -y 直接执行修正后的命令。

  3. 递归纠正：使用 fuck -r 递归纠正命令直到成功。

2. tldr 使用技巧

  1. 基本查询：tldr <命令> 显示指定命令的帮助。

  2. 指定平台：tldr -p linux <命令> 显示特定平台的命令用法。

  3. 更新数据：定期运行 tldr --update 同步最新的帮助文档。

  4. 搜索命令：tldr --search <关键词> 搜索相关命令。

参考链接