每个开发者都有过这样的经历：手指飞快地敲下一串命令，回车执行，然后屏幕上赫然显示：

$ gut stattus
zsh: command not found: gut

明明想打 git status，结果手一抖，全错了。重新输入？浪费时间。复制粘贴？更麻烦。

Typo 就是为解决这个问题而生的命令行自动纠错工具。按两次 Esc，命令自动修正。

TheFuck ？

实际使用中，theFuck 存在一些问题：

1. 依赖 Python 版本，会出现安装报错问题；
2. git commit -s -m "sss" 修正时，会吞掉引号； https://github.com/nvbn/thefuck/issues/1543
3. 仓库不更新了。

为此，有了 Go 编写的 Typo 。

快速上手

安装

方式一：Go 安装（推荐）

go install github.com/yuluo-yx/typo/cmd/typo@latest

方式二：下载二进制

从 GitHub Releases 下载对应平台的二进制文件：

# 以 macOS ARM64 为例
curl -LO https://github.com/yuluo-yx/typo/releases/latest/download/typo-darwin-arm64
chmod +x typo-darwin-arm64
sudo mv typo-darwin-arm64 /usr/local/bin/typo

方式三：源码编译

git clone https://github.com/yuluo-yx/typo.git
cd typo
make install

配置 Shell 集成

在 ~/.zshrc 中添加一行：

eval "$(typo init zsh)"

重启终端，完成！

使用

1. 输错命令时，按 Esc Esc，命令自动修正
2. 命令执行失败后，按 Esc Esc，修正上一条命令

$ gut stattus<Esc><Esc>   # 自动变成 → git status
$ dcoker ps<Esc><Esc>      # 自动变成 → docker ps

核心功能

1. 多层级智能纠错

Typo 按优先级依次尝试四种纠错策略：

2. 键盘布局感知

不同于简单的字符串匹配，Typo 知道你的键盘布局。

打 gut 时，u 和 i 在键盘上相邻，所以 gut → git 的可能性很高。而 got → git 就没那么确定，因为 o 和 i 距离较远。

这种基于 QWERTY 键盘布局的算法让纠错更精准。

3. 子命令智能修正

不仅修正主命令，还能修正子命令：

$ git stattus   → git status
$ docker biuld  → docker build
$ npm isntall   → npm install

支持的工具：git 、docker 、npm 、yarn 、kubectl 、cargo 、go 、pip 、brew 、terraform 、helm

4. 错误输出解析

当你执行一个命令失败后，工具本身可能会提示正确命令。Typo 能捕捉这些提示：

$ git pshh
git: 'pshh' is not a git command. See 'git --help'.
Did you mean this?
        push

按 Esc Esc，Typo 会直接用 git push 替换。

5. 自定义规则

你可以教 Typo 学习新的纠正规则：

# 学习一条规则
typo learn "gut" "git"

# 查看所有规则
typo rules list

# 添加自定义规则
typo rules add "dcoker" "docker"

便捷命令

为什么选择 Typo ？

配置文件

Typo 的数据存储在 ~/.typo/ 目录：

~/.typo/
├── history.json       # 修正历史（自动记录）
├── rules.json         # 自定义规则
└── subcommands.json   # 子命令缓存

遇到问题？

运行 typo doctor 诊断配置状态：

$ typo doctor
Checking typo configuration...

[1/4] typo command: ✓ available (/usr/local/bin/typo)
[2/4] config directory: ✓ /Users/you/.typo
[3/4] shell integration: ✓ loaded
[4/4] Go bin PATH: ✓ configured

All checks passed!

立即尝试

go install github.com/yuluo-yx/typo/cmd/typo@latest
echo 'eval "$(typo init zsh)"' >> ~/.zshrc

GitHub: https://github.com/yuluo-yx/typo

如果觉得有用，欢迎 Star 支持！