Hunspell 拼写检查完全教程

Hunspell 是世界上最广泛使用的拼写检查引擎，被 LibreOffice、Firefox、Chrome、macOS、VS Code 等众多软件采用。本教程从基础概念到高级用法，系统讲解 Hunspell 的安装、使用、词典开发与编程集成。

教程总览

本教程共 10 章，覆盖 Hunspell 的方方面面：

章节	标题	核心内容
01	Hunspell 概述	背景历史、竞品对比、适用场景
02	安装与环境配置	各平台安装、词典包、语言支持
03	基本使用	命令行、交互模式、管道、批量检查
04	词典文件格式	`.dic`/`.aff` 格式、编码规范
05	词缀规则详解	PFX/SFX、条件替换、组合标志
06	自定义词典开发	个人词典、词表管理、affix 标志
07	编程接口	C API、Python、Node.js、Go 集成
08	编辑器与工具集成	LibreOffice、Firefox、VSCode、CI
09	形态学分析	复合词、屈折/派生、特殊语言处理
10	最佳实践	词典维护、性能优化、多语言策略

适合谁阅读

开发者：需要在应用中集成拼写检查功能
技术写作者：希望优化文档质量、减少拼写错误
语言工程师：需要为新语言创建或维护词典
运维工程师：需要在 CI/CD 中集成自动化拼写检查
开源爱好者：对 NLP 基础工具感兴趣

阅读建议

新手入门：建议从第 1-3 章顺序阅读，快速上手基本用法
词典开发：重点阅读第 4-6 章，掌握词典格式与词缀规则
编程集成：第 7-8 章提供多种语言的完整示例
高级主题：第 9-10 章涵盖形态学分析与生产环境最佳实践

Hunspell 生态一览

┌─────────────────────────────────────────────────┐
│                 应用层 (Applications)              │
│  LibreOffice │ Firefox │ Chrome │ VSCode │ Emacs │
├─────────────────────────────────────────────────┤
│              Hunspell 引擎 (Library)              │
│          libhunspell — C/C++ 核心库              │
├─────────────────────────────────────────────────┤
│              词典文件 (Dictionaries)              │
│     en_US.dic + en_US.aff │ zh_CN.dic + .aff    │
├─────────────────────────────────────────────────┤
│            语言数据 (Language Data)               │
│     词根词表 │ 词缀规则 │ 形态学规则 │ 例外词    │
└─────────────────────────────────────────────────┘

环境准备

教程中的命令示例基于以下环境，其他平台的差异会在各章节中说明：

项目	版本/说明
操作系统	Ubuntu 22.04 LTS / macOS 13+ / Windows 11
Hunspell	1.7.x+
包管理	apt / brew / pacman
编程语言	Python 3.10+, Node.js 18+, Go 1.20+

扩展阅读

许可说明：Hunspell 使用 LGPL/GPL/MPL 三重许可，可自由集成到开源与商业项目中。