安装 Tesseract OCR
几分钟即可完成。
面向 Windows、macOS、Linux、WSL2、Docker 和 Conda 的完整、经过验证的安装指南，包含 PATH 配置、语言数据、安装验证以及常见错误的解决办法。
快速安装（一条命令）
复制适合你平台的命令。语言与 PATH 的说明见下文。
Windows
包管理器，或 UB Mannheim 安装程序。
> winget install UB-Mannheim.TesseractOCR
macOS
推荐使用 Homebrew。
$ brew install tesseract
Ubuntu / Debian
官方仓库中提供。
$ sudo apt install tesseract-ocr
该选择哪种安装方式？
选择与你的环境对应的行。下文将逐一详解每种方式。
| 方式 | 适合 | 语言数据 | 管理员权限 |
|---|---|---|---|
| UB Mannheim 安装程序（Windows） | 大多数 Windows 用户 | 安装时选择 | 需要（全系统） |
| winget / scoop / choco | 脚本或用户级 Windows 安装 | 需另行添加 | scoop：不需要 |
| Homebrew / MacPorts（macOS） | macOS 开发 | tesseract-lang | 不需要 |
| apt / dnf / pacman / apk | Linux 服务器与桌面 | 按语言分包的软件包 | 需要（sudo） |
| WSL2 | 同时需要训练模型的 Windows 用户 | apt 软件包 | 不需要 |
| Docker | 可复现的服务与 CI | 已打包进镜像 | 不需要 |
| Conda | 数据科学环境 | conda-forge | 不需要 |
在 Windows 上安装
Tesseract 在 Windows 上不易编译。请使用社区安装程序或包管理器，然后把它加入 PATH。
方式 A — UB Mannheim 安装程序（推荐）
UB Mannheim 项目提供 Tesseract 5.x 的 Windows 标准构建（64 位与 32 位）。安装程序包含训练工具，并可在安装时选择语言。
- 从 UB Mannheim 页面下载最新的
tesseract-ocr-w64-setup-5.x.exe。 - 运行安装程序，勾选所需语言（或全部）。
- 安装到默认路径
C:\Program Files\Tesseract-OCR。 - 把该文件夹加入 PATH（见下），然后重启终端。
方式 B — 包管理器
> winget search tesseract
> winget install UB-Mannheim.TesseractOCR
> scoop install tesseract
> choco install tesseract
包 ID 会随时间变化：若命令失败，请先运行 winget search tesseract 或 scoop search tesseract。
把 Tesseract 加入 PATH（最容易被忽略的一步）
若使用 UB Mannheim 安装程序，只有把该文件夹加入 PATH，才能找到 tesseract。
- 打开开始菜单，搜索 环境变量，选择 编辑系统环境变量。
- 点击 环境变量…，在 系统变量 中选择 Path 并点击 编辑。
- 点击 新建，添加
C:\Program Files\Tesseract-OCR。 - 逐级确定，并完全重启终端（以及 IDE）。
> tesseract --version
在 macOS 上安装
无论 Apple Silicon 还是 Intel，都推荐使用 Homebrew。
$ brew install tesseract
$ brew install tesseract-lang # 全部语言
Homebrew 会把二进制安装到 /opt/homebrew/bin（Apple Silicon）或 /usr/local/bin（Intel）。语言数据位于 tessdata 目录，可用 brew info tesseract 查看。
使用 MacPorts 的替代方案
$ sudo port install tesseract
$ sudo port install tesseract-语言代码 # 例如 tesseract-fra
在 Linux 上安装
所有主流发行版都在官方仓库中提供 Tesseract。
Debian / Ubuntu / Mint
$ sudo apt update
$ sudo apt install tesseract-ocr libtesseract-dev
$ sudo apt install tesseract-ocr-all # 可选：全部语言
如果 apt 找不到软件包，请启用 universe 仓库。libtesseract-dev 仅在需要针对 API 编译时才需要。
Fedora / RHEL
$ sudo dnf install tesseract tesseract-devel tesseract-langpack-eng
Arch / Manjaro
$ sudo pacman -S tesseract tesseract-data-eng
Alpine
$ apk add tesseract-ocr tesseract-ocr-dev tesseract-ocr-data-eng
需要更新的版本？请按官方编译指南从源码编译。
在 Windows 上使用 WSL2 安装
WSL2 在 Windows 内提供完整的 Linux 环境，是同时想训练模型时最简便的方式。
> wsl --install -d Ubuntu
$ sudo apt update && sudo apt install tesseract-ocr tesseract-ocr-all libtesseract-dev
使用 Docker 安装
对于可复现的服务和 CI，可将固定版本与语言的 Tesseract 打包进镜像。
创建 Dockerfile：
FROM ubuntu:24.04
RUN apt-get update \
&& apt-get install -y --no-install-recommends \
tesseract-ocr tesseract-ocr-eng tesseract-ocr-chi-sim libtesseract-dev \
&& rm -rf /var/lib/apt/lists/*
ENTRYPOINT ["tesseract"]$ docker build -t tesseract .
$ docker run --rm -v "$PWD:/data" tesseract /data/image.png /data/out
挂载卷后，Tesseract 才能读取图片并把 out.txt 写回主机。需要更多语言时，在 Dockerfile 中加入 tesseract-ocr-<语言> 软件包。
使用 Conda 安装
适合无法使用系统包管理器的数据科学环境。
$ conda install -c conda-forge tesseract
安装语言数据（tessdata）
引擎默认包含英语。可通过软件包或 .traineddata 文件添加更多语言。
安装语言包
$ sudo apt install tesseract-ocr-fra tesseract-ocr-deu # Debian/Ubuntu
$ brew install tesseract-lang # macOS（全部）
$ sudo dnf install tesseract-langpack-fra # Fedora
手动安装 .traineddata 文件
- 从官方仓库下载语言文件：tessdata_fast（速度）、tessdata_best（精度）或 tessdata（旧版）。
- 把
.traineddata文件复制到你的tessdata目录（例如C:\Program Files\Tesseract-OCR\tessdata、/usr/share/tesseract-ocr/5/tessdata或$(brew --prefix)/share/tessdata）。 - 如果数据在别处，用环境变量
TESSDATA_PREFIX指向它。 - 用
tesseract --list-langs列出可用语言以确认。
| 仓库 | 取舍 | 适用场景 |
|---|---|---|
tessdata_fast | 体积最小、速度最快，精度略低 | 实时或高吞吐流水线 |
tessdata_best | 精度最高，速度较慢、体积较大 | 归档或对精度要求高的场景 |
tessdata | 旧版 + LSTM，支持 --oem 0 | 旧模型或需要旧版兼容 |
验证安装
继续之前先运行这三项检查。若有失败，请查看故障排查表。
$ tesseract --version
$ tesseract --list-langs
$ tesseract sample.png stdout -l eng
成功运行会显示版本、列出 eng（以及已安装语言），并输出从图片中识别出的文本。
升级、管理与卸载
保持引擎为最新版本，或彻底移除。
| 任务 | Windows | macOS | Linux |
|---|---|---|---|
| 升级 | winget upgrade / 重新运行安装程序 | brew upgrade tesseract | sudo apt upgrade tesseract-ocr |
| 卸载 | winget uninstall UB-Mannheim.TesseractOCR | brew uninstall tesseract | sudo apt remove tesseract-ocr |
| 多版本共存 | PATH 中只保留一个 | 不要混用 brew 与 MacPorts | 使用 PPA 或从源码编译 |
故障排查
以下情况覆盖了绝大多数安装问题。
| 症状 | 原因 | 解决办法 |
|---|---|---|
tesseract: command not found | 安装目录不在 PATH 中 | 把 C:\Program Files\Tesseract-OCR（Windows）或 brew 的 bin（macOS）加入 PATH，并重启终端。 |
Error opening data file .../eng.traineddata | 缺少语言数据或路径错误 | 安装对应语言包，或把 TESSDATA_PREFIX 设为包含 eng.traineddata 的目录。 |
TesseractNotFoundError（Python） | pytesseract 找不到二进制文件 | 把 pytesseract.pytesseract.tesseract_cmd 设为完整路径，或修正 PATH。 |
| 版本不正确 | PATH 中有多个安装 | 调整 PATH 顺序或删除重复项；使用 which -a tesseract / where tesseract。 |
| 权限被拒绝 | 无权限的系统安装 | Linux 上使用 sudo，或用 scoop/Conda 进行用户级安装。 |
| Docker 找不到图片 | 未挂载卷 | 用 -v "$PWD:/data" 挂载目录，并在容器内使用 /data/...。 |
安装常见问题
如何在 Windows 上安装 Tesseract OCR？
下载适用于 Tesseract 5.x 的 UB Mannheim 安装程序并运行，把 C:\Program Files\Tesseract-OCR 加入 PATH，用 tesseract --version 验证。也可以使用 winget、scoop 或 chocolatey。
如何在 Ubuntu 上安装 Tesseract OCR？
运行 sudo apt update && sudo apt install tesseract-ocr libtesseract-dev。如需要请启用 universe 仓库，安装全部语言可运行 tesseract-ocr-all。
Tesseract 安装在哪里？
Windows：C:\Program Files\Tesseract-OCR。macOS 使用 Homebrew：/opt/homebrew（Apple Silicon）或 /usr/local（Intel）。Linux：通常为 /usr/bin/tesseract，数据在 /usr/share/tesseract-ocr/。
Python 还需要安装什么吗？
需要。pytesseract 只是调用 Tesseract 二进制的封装，因此请先安装引擎，再运行 pip install pytesseract pillow。文档中有一个最小示例。
没有管理员权限可以安装吗？
可以。Windows 上使用 scoop 或便携版，任何系统上都可以用 conda install -c conda-forge tesseract。
Tesseract 商用免费吗？
免费。Tesseract 以 Apache 2.0 许可证发布，个人、学术和商业用途均可免费使用。
后续步骤
安装完成后，学习如何使用它。