Tesseract OCR实战指南：安装、优化与自定义字库训练

1. 环境安装：Tesseract OCR 的完整落地指南

1.1 Windows 平台安装：别被“史上最全”忽悠了

先聊安装这件事。不少新手一上来就找所谓“史上最全安装教程”，结果被各种乱七八糟的步骤劝退。实际上 Tesseract 在 Windows 上的安装就三步：下载安装包、装语言包、配环境变量。但里面有几个坑是官方文档不会明说的。

第一，版本选择。很多人习惯点“最新版本”，但 Tesseract 的 UB Mannheim 构建版（也就是社区维护的 Windows 版）目前主流稳定版本是 5.x 系列。版本 5.0 开始引入了基于 LSTM 的识别引擎，相比老版本 3.x、4.x 的 Legacy 引擎，识别率有了质的飞跃，尤其是对自然场景图片、倾斜文本、复杂排版的容错率明显提高。我的建议是直接用 5.x，别回头折腾旧版，除非你有特殊的兼容需求。

第二，安装路径。默认安装路径是C:\Program Files\Tesseract-OCR，这个路径本身没问题，但注意 Program Files 带空格，在一些老旧工具链或者自己写的脚本里，如果没处理好引号，容易出现路径解析错误。为了避免不必要的麻烦，我习惯自己指定一个无空格路径，比如D:\Tesseract-OCR，实测能省掉后面很多鬼问题。

第三，语言包。安装器默认只带英文（eng），如果你要识别中文，需要额外下载chi_sim.traineddata（简体中文）或chi_tra.traineddata（繁体中文），下载后放到tessdata目录下。这里有个判断技巧：安装完成后在命令行跑一下tesseract --list-langs，能看到列出的语言代码，就说明语言包已经就位。

配置环境变量这一块，需要把 Tesseract 的安装目录加到系统 PATH 中，同时新建一个TESSDATA_PREFIX环境变量指向tessdata目录。为什么要单独配这个变量？因为后续如果你训练了自己的字库，默认 tessdata 目录是在安装目录下的，不配这个变量而使用自定义目录时，系统会找不到训练数据。

1.2 Linux/macOS 安装：几条命令的事

如果是 Ubuntu/Debian 系，用apt-get install tesseract-ocr tesseract-ocr-chi-sim就能装好，注意那个tesseract-ocr-chi-sim包名，装完中文语言包就有了。macOS 用brew install tesseract tesseract-lang，这个更省事，把全部语言包都拉下来了。

需要特别留意的点是：系统源里的 Tesseract 版本不一定是最新的，比如某些 Ubuntu 发行版自带 4.x 老版本。如果你想用新版，建议直接从 GitHub 上编译安装。编译过程需要配置 leptonica（底层图像处理库），依赖关系稍微复杂一点，建议按照官方文档一步步来，不要跳步。

2. 图片解析实战：从命令行到核心参数

2.1 命令行基础用法：一张图怎么跑出文字

安装好之后，最基础的调用方式就是命令行：

tesseract input.png output -l chi_sim

这条命令的意思是：识别input.png中的文字，指定语言为简体中文（chi_sim），输出结果保存到output.txt。如果不指定-l参数，默认使用英文识别。

但我得说一句，命令行能跑通只是“第一步”，实际识别一张图往往不是一次就能拿到满意结果的。比如图片背景有杂色、文字有倾斜、分辨率太低，都会影响识别率。Tesseract 对“干净”的图片最友好，所以很多场景下你需要先对图片做预处理，灰度化、二值化、降噪，然后再丢给 Tesseract。

这里分享一个实用的预处理思路：在调用 Tesseract 之前，先用 Python 的 Pillow 或 OpenCV 把图片转成灰度图，再做一个简单的自适应阈值二值化，最后把尺寸适当放大（比如 2~3 倍）。放大听起来反直觉，但 Tesseract 的 LSTM 引擎对像素密度很敏感，过低的分辨率会严重劣化识别结果，适当放大反而能显著提升准确率。

2.2 psm 参数：一个常常被忽略但极其有用的选项

Tesseract 的--psm（Page Segmentation Mode）参数，决定了引擎怎么理解页面布局。这是最容易被初学者忽略的点，但恰恰是影响识别成败的关键，尤其是在结构复杂的图片上。

常用的几种模式（只列出实际开发中最常碰到的）如下表所示：

举个例子，如果你要识别一张只有一行文字的截图，用默认模式 psm 3，引擎会先去分析页面结构，猜测哪里是标题、哪里是正文、哪里是页脚，这一通分析既费时间又可能“想太多”，把本来独立的一行文字拆得七零八落。而直接指定--psm 7，告诉引擎“别费劲了，这就是一行”，识别速度和准确率都会明显提升。

我在实际运用中还有个经验：用--psm 6识别卡片类文字（比如名片、铭牌）效果好于--psm 3，因为 psm 6 假设页面是一整个文本块，不会因为卡片四周留白而做多余的分割。另外，老版本的-psm是短横线连接，新版本改成了--psm，两横别写错。

2.3 白名单限制：让识别结果更符合预期

另一个很实用的参数是-c tessedit_char_whitelist，也就是字符白名单。比如你要识别一个车牌号，只需要“省份简称 + 字母 + 数字”，直接把白名单设置为：

tesseract input.jpg output -l chi_sim --psm 7 -c tessedit_char_whitelist="京津冀晋蒙辽吉黑沪苏浙皖闽赣鲁豫鄂湘粤桂琼渝川贵云藏陕甘青宁新ABCDEFGHIJKLMNOPQRSTUVWXYZ0123456789"

这样引擎在识别过程中只会从白名单里选字符，能极大减少无意义的干扰输出，比如把“O”误识成“0”，或者把“I”误识成“1”这类问题。注意，中文字符的白名单本身需要语言包支持，但白名单机制对中文同样有效。

顺带提一句白名单有个小坑：不同语言包对字符集合的支持范围有差异，个别冷门字符（比如“鄂”在某些版本的字库中缺失）即使加进了白名单也不一定能被识别出来，这种情况只能靠后面讲的“字库训练”来解决。

3. 训练自己的字库：从零到可用的完整流程

3.1 为什么最终都要走向自己训练字库

官方预训练字库覆盖的字体、字号和排版模式有限。举个例子，如果图片里的文字是手写体，或者用了比较特殊的艺术字体，官方字库的识别准确率很可能让人抓狂。现实世界中这类图片并不少见：发票上的手写金额、快递单上手写的地址、品牌 Logo 上的特殊设计字体。

这就是“训练自己的字库”存在的意义。训练字库的核心逻辑，是给 Tesseract 喂一批“你知道答案”的图片，告诉它“这张图里写的字是什么”，让它从这些样本中学习对应关系，从而生成一个适应你特定场景的语言模型。本质上跟新员工入职培训是一个道理，官方字库是一个通才，你训出来的字库是一个定向专才。

另外，Tesseract 目前有两种引擎内核：经典的 Legacy 引擎和 LSTM 引擎。LSTM 是神经网络（长短期记忆网络），对复杂场景的识别能力更强，也是 5.x 的默认引擎。训练方法也对应两套体系，本文主要讲 LSTM 方法的训练流程，因为这是当前的主流方向。

3.2 训练前的准备工作：数据采集和标注

训练了自己的字库才发现，真正花时间的不是跑训练脚本，而是准备训练数据。要获得一个效果堪用的字库，至少需要准备 50~100 张不同风格、不同背景的图片作为训练集。如果场景更复杂（比如有多种字体混排、倾斜、扭曲），样本量建议在 300 张以上，不然训练出来的模型很容易在见过的样张上表现良好，一遇到真实场景就“翻车”。

数据标注的形式有两种：一种是直接用 Tesseract 的 box 文件标注，另一种是生成“图片-文本”配对数据（ground truth）。Box 文件可以理解为一张图片上的每个字符的行列坐标和对应字符值，是最原始、也是 Tesseract 训练数据生成工具 jTessBoxEditor 直接支持的格式。

具体做法是：用 jTessBoxEditor 打开一张训练图片，它会自动做初始的字符合并和识别，生成一个 box 文件，然后人工逐字校正。这个过程比较繁重，如果样本量大，可以考虑先用 Tesseract 自己跑一遍识别生成初始 box，再人工修错，比从零开始画框快得多。

3.3 LSTM 训练的具体流程：一条命令跑通，细节决定成败

Tesseract 官方推荐的 LSTM 训练流程，本质是围绕tesstrain.sh这个封装脚本展开的。完整流程大致如下：

第一步，准备一张 TIFF 格式的训练样本集。Tesseract 要求所有训练样本以.tif后缀保存，且文件名有特定格式：[语言名].[字体名].exp[编号].tif。比如chi_sim.myfont.exp0.tif和chi_sim.myfont.exp1.tif，这个格式不能乱来，因为后续所有脚本都是靠这个命名规则来找到对应文件的。批量图片可以用 ImageMagick 的convert命令转格式：

convert img1.png -compress none chi_sim.myfont.exp0.tif

第二步，生成 box 文件并校正。用 jTessBoxEditor 打开 TIF 文件，逐个检查字符的分割框和文本内容，改正所有错分和误标。这一步是纯体力活，但对训练效果影响巨大，“垃圾进、垃圾出”这个道理在机器学习领域永远不会过时。

第三步，生成 LSTM 训练数据。从 4.0 版本之后，Tesseract 支持直接从现有字库的 LSTM 部分“微调”训练（fine-tune），而无需从头训练。这种做法能大幅节约训练时间，尤其在样本量不多的情况下。命令行示例：

tesseract chi_sim.myfont.exp0.tif chi_sim.myfont.exp0 -l chi_sim lstm.train

第四步，提取 LSTM 初始模型。需要先从官方字库中提取.lstm文件作为训练起点：

combine_tessdata -e chi_sim.traineddata chi_sim.lstm

第五步，正式训练。Tesseract 5.x 的训练推荐用tesstrain.sh，脚本会帮你处理很多中间过程，个人开发者不需要手写底层训练循环。核心命令：

tesstrain.sh --model_name myfont --lang chi_sim \ --linedata_only --noextract_font_properties \ --training_text ./ground_truth.txt \ --max_iterations 400

max_iterations这个参数要看具体任务灵活调整，官方默认大概是 400 到 1000 之间。样本量大、风格多变时多跑一些轮次；如果只有 50 张图，迭代 400 次已经比较充裕，跑多了很容易出现过拟合。

第六步，合并字库。训练过程中会生成若干检查点（checkpoint），其中.traineddata文件就是训练结果。但注意，这个训练产物只包含“新增”字库部分，要让它能配合中文字库一起工作，需要用combine_tessdata把基础字库和新增部分合并：

combine_tessdata chi_sim.myfont.traineddata

合并完成后，把最终的.traineddata文件放到 Tesseract 的tessdata目录下，即可通过-l chi_sim使用这一套新字库了。

3.4 一个容易踩坑的训练细节：文字标注的规范性

关于训练样本的标注，我单独拿出来说，因为这是我自己踩过最深的坑。在做 OCR 字库训练时，标注文本需要遵循“每行一个文本块”的排版规则，而且文本块最好能均匀分布在一整行上。标注时尽量少用制表符或空格，因为 LSTM 训练倾向于把一行文本当作一个时间序列，空格和制表符会被处理成额外的空白节点，干扰训练收敛。

此外，如果样本中出现了不认识的生僻字，box 文件里的字符必须确保是 Unicode 编码，并且该字符必须在你选定的语言包白名单中存在（即初始字库里有这个字的形）。别问我怎么知道的，满屏的“口口口”乱码会告诉你答案。遇到这种字，要么换一个包含它的基础字库，要么考虑在训练样本中用同音字或相同偏旁部首的字替代，但识别率会打折扣，所以最稳的还是先确认基础字库的覆盖面。

4. 识别效果优化：从“能跑”到“能看”

4.1 图片预处理：识别率提升的隐藏杠杆

图片预处理的重要性，我上面提到过一次，但真正做项目的时候很多人还是会忽略。这里再说透一点。

Tesseract 的 LSTM 引擎对输入图像是比较“挑剔”的。正常的黑字白底印刷体识别率很高，一旦图像背景有纹理、光照不均匀或者文字有透视变形，识别率断崖式下跌。

我常用的预处理链路是：

1. 灰度化：去掉颜色信息，减少干扰。
2. 二值化：将图像转为纯黑白的二值图，保证文字部分是黑色，背景是白色。
3. 去噪：用中值滤波或高斯模糊去除背景噪点。
4. 透视矫正/倾斜矫正：用 OpenCV 检测文本区域的边缘，做仿射变换。
5. 适当的缩放：上面说过，放大 2~3 倍对 LSTM 尤其友好。

这五步下来，很多原本识别率只有 30% 的图，至少能提升到 70%~80%。如果你的样本场景相对固定（比如都是拍照发票），建议把预处理做成脚本批处理，能省下大量测试时间。

4.2 多页 PDF 的处理思路

有些场景下，OCR 的对象不是单张图片，而是一份多页 PDF。Tesseract 本身不直接支持 PDF 输入，需要先把 PDF 拆成图像帧，再逐页处理。官方配套的tesseract input.pdf output -l eng在较新版本中已经能直接读取 PDF，底层是先通过 Leptonica 将 PDF 转换为高分辨率 TIF，但转换质量依赖 PDF 中的图像分辨率和压缩方式，实际效果不一定理想。

更可控的做法是用 Python 的 pdf2image 将 PDF 渲染为高分辨率图片（300 DPI），再进入预处理和识别流程。识别完成后，还可以将每页的识别文本输出为相应的 TXT 文件，后续再做文本合并和结构化分析。

4.3 与其它开源 OCR 方案横向对比

既然是在做 OCR 相关的踩坑实践，就绕不开不断涌现的其他开源 OCR 方案。最近大家讨论很多的 PaddleOCR 也是一个很有力的竞争者。二者适用场景截然不同，我放在一张表里做对比：

Tesseract 最让我看重的一点是“轻”——它依赖少、运行简单、离线可用，适合嵌入式设备、离线数据分析脚本、以及需要快速验证想法的场景。而 PaddleOCR 则在复杂排版、多语种混合、前沿模型方面走得更快。二选一不如看场景，我是两边都备着，谁合适用谁。

5. 常见问题与排查技巧实录

5.1 “Tesseract 安装成功后，命令行却提示不是内部或外部命令”

这个问题出现的频率非常高。要么是安装时没有勾选“Add Tesseract to the system PATH”（安装器默认不勾选），要么是环境变量配置未生效。解决办法：手动添加D:\Tesseract-OCR（以实际安装路径为准）到“系统变量-Path”中，并重新打开命令行窗口。如果再不行，确认一下是否在 PATH 中写了安装目录本身，而不是安装目录下的 bin 子目录。

5.2 “识别结果全乱码，可明明图片上的字很清晰”

常见原因有三：语言包缺失或放错位置、使用了错误的-l参数、图片本身没有被预处理。先跑一下tesseract --list-langs，确认语言包已加载。如果语言包存在但还是乱码，检查图片是否色彩复杂、背景是否杂乱，做一轮预处理试试。

5.3 训练时报“Could not create a primitive ... no text detected”

这个报错经常出现在自己制作训练样本时，用图片工具随便截了一张图，但图片中文字区域占比过小，导致 Tesseract 没有识别到足够的文本区域，也就生成不了有效的 box 文件，于是训练无法启动。解决思路：放大文字区域、清理背景，确保在一张图中文本占据的面积足够显著。还有一个技巧是，开始训练前用命令tesseract sample.tif output -l eng先做一次快速识别，看看引擎能不能自己识别出东西，如果这一步输出空，说明图片本身质量就不够格。

5.4 训练时间过长，如何取舍

仅用 CPU 跑训练，350~400 张图的训练集可能需要几十分钟到数小时，取决于图片大小和迭代次数。如果对训练速度敏感，建议合理控制样本图片的尺寸，文字区域高度建议控制在 32~64 像素之间，过大尺寸只会增加计算负担，对最终识别率提升有限。还有就是合理控制迭代轮次，在训练过程中观察 Loss 值，一旦收敛稳定（比如连续多轮 Loss 波动很小），就可以提前停了，没有必要硬跑满固定迭代数。

6. 实战中的心得与一条小技巧

最后分享一条关于“字库文件加载顺序”的经验。Tesseract 加载语言包时是严格遵守顺序的：如果你把自定义字库命名成chi_sim.traineddata覆盖了官方文件，那么你以前在官方字样上的识别能力会被大幅削弱。为了避免这种问题，建议训练完的自定义字库不要覆盖原始文件，而是单独命名（比如chi_sim_custom.traineddata），然后通过-l chi_sim_custom按需调用。这样官方引擎的能力依然保留，自定义字库按场景切换，两边互不干扰。这是我踩过几次坑、交了不少“学费”之后总结出来的，非常管用。