Typos 源码拼写检查器

它解决什么问题

代码评审中最磨人的一类问题往往不是逻辑错误，而是拼写：一个叫 futer 的变量、注释里的 recieve、文档中的 occured。这类错误编译器不报错，测试照样通过，却在长期维护中持续制造认知负担，还会影响搜索命中率和 API 文档质量。typos 就是为这类问题而生的——它不追求理解代码语义，只专注于一件事：在源代码里找出拼写可疑的单词，并给出修正建议。

它如何工作

typos 是一个用 Rust 编写的工具，启动快、单遍扫描即可覆盖整个代码库，因此可以直接跑在 monorepo 上。其工作方式可以概括为三步：

• 扫描：按项目结构遍历源码，默认只读，不会改动任何文件；
• 识别与建议：对标识符、注释、字符串做拼写分析，依靠内置词典与纠错规则尽量压低误报；
• 修复：确认问题后，可用 --write-changes 参数把修正写回文件。

行为可通过配置文件细调，支持 TOML、JSON、YAML 三种格式，例如忽略特定单词、排除目录、追加自定义词典。覆盖范围也很广：从 Rust、Python、Go 等主流语言，到 SQL、YAML、TOML、JSON 等数据格式，再到 Makefile、CMakeLists.txt、package.json、CI 配置文件，都在检查之列。

适用边界与注意点

• 它只做拼写检查，不替代 linter 或类型检查；语法正确但拼错的名字才是它的领地；
• 默认不写文件，启用自动修复前建议先跑一次干跑模式确认输出；
• 命中结果未必是错误——领域术语、专有名词可能被标记，需要靠忽略列表或自定义词典处理；
• 它按语言和文件类型工作，对代码语义一无所知，不要指望它发现命名风格问题。