告别手残！ Typo 按 Esc 两次自动修正命令行输错

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

$ 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	typo-darwin-arm64
macOS AMD64	typo-darwin-amd64
Linux AMD64	typo-linux-amd64
Linux ARM64	typo-linux-arm64
Windows	typo-windows-amd64.exe

# 以 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 按优先级依次尝试四种纠错策略：

优先级	策略	说明
1	错误解析	提取工具自身的 "did you mean" 建议
2	历史记录	使用你之前学过的纠正
3	规则匹配	内置 50+ 规则 + 自定义规则
4	编辑距离	基于键盘布局的模糊匹配

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 fix "gut stauts"	直接修正命令
typo learn "gut" "git"	学习纠正规则
typo rules list	列出所有规则
typo history list	查看修正历史
typo doctor	诊断配置问题
typo uninstall	完全卸载

---

为什么选择 Typo ？

特性	Typo	其他纠错工具
按键触发	Esc Esc	需要特定命令
键盘布局感知	支持	大多不支持
子命令修正	支持	部分支持
错误输出解析	支持	少见
自定义规则	支持	部分支持
安装复杂度	一行命令	可能需要额外配置

---

配置文件

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 支持！