tesseract 是 Go OCR 的实际依赖核心，所有“Go 实现 OCR”本质是调用系统 tesseract 可执行文件或云 API；常见失败源于未安装、PATH 未配置或语言包路径错误。
tesseract 是 Go 做 OCR 的实际依赖核心，Go 本身不带 OCR 能力，所有「Go 实现 OCR」的表述，本质都是调用系统级 tesseract 可执行文件，或转发请求到云 API。没装对、没配好、语言包路径错，90% 的失败都卡在这三步。
exec: "tesseract": executable file not found in $PATH 怎么修
这是最常见报错，不是 Go 代码问题，是环境缺失。Go 的 gosseract 或 gotesseract 库底层用 os/exec.Command("tesseract", ...) 启动进程，找不到可执行文件就直接 panic。
- 终端直接运行
tesseract --version，必须能输出类似tesseract 5.4.1；若提示 command not found，说明没装或没加进$PATH - Linux/macOS：用
sudo apt install tesseract-ocr（Debian/Ubuntu）或brew install tesseract（macOS），再确认which tesseract输出路径是否在$PATH中 - Windows：下载官方 installer（如
tesseract-ocr-w64-setup-v5.4.1.20240917.exe），安装时勾选「Add to PATH」；若漏了，手动把安装目录（如C:\Program Files\Tesseract-OCR）加进系统环境变量 Path - 验证语言支持：
tesseract --list-langs，输出里必须有chi_sim才能识中文；没有？说明语言包没装或放错位置
中文识别为空或乱码，Lang 参数怎么设
gosseract.SetLanguage("chi_sim+eng") 看似合理，但实际生效取决于两件事：语言包文件名是否匹配、tessdata 目录是否被正确识别。
- 语言包必须下载对应版本的
chi_sim.traineddata（例如 v5.4.1 就不能用 v4.x 的包），从 tesseract-ocr/tessdata 下载，放到tessdata目录下 -
tessdata默认路径因系统而异：Linux 通常是/usr/share/tesseract-ocr/4.00/tessdata或/usr/share/tesseract-ocr/tessdata；macOS 是/opt/homebrew/share/tessdata；Windows 是安装目录下的tessdata文件夹 - Go 代码中显式指定路径更稳：
client.SetDatapath("/usr/share/tesseract-ocr/tessdata")，避免依赖系统自动查找 - Lang 字符串必须严格等于文件名前缀（不含
.traineddata），比如文件叫chi_sim.traineddata，就只能传"chi_sim"；"chi_sim+eng"是合法组合，但要求两个包都存在且路径正确
识别率低，要不要用 gocv 做预处理
可以，但别一上来就堆滤波和膨胀——多数模糊/倾斜图片，tesseract 自带的 -psm（page segmentation mode）参数就能解决，比写预处理代码更快更可靠。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 先试命令行快速验证：
tesseract example.png stdout -l chi_sim -psm 6（6 表示“假设为单文本行”，适合身份证、票据等规整区域） - 常用
-psm值：3（全自动，缺省）、6（单行）、7（单字）、8（单字作为字符），Go 代码中用client.SetPageSegMode(6) - 真要上
gocv：只做三件事就够了——转灰度（IMReadGrayScale）、自适应二值化（AdaptiveThreshold）、透视校正（GetPerspectiveTransform+WarpPerspective）；其余如去噪、锐化，往往引入新噪声 - 注意内存泄漏：
gocv的Mat对象必须显式.Close()，否则跑批量任务会 OOM
要不要直接调云 API 而不是折腾本地 tesseract
看场景。如果你的图片质量差、版面复杂（如表格、多栏、手写）、或需要高准确率 SLA，云 API 是更省心的选择；但若涉及隐私数据、离线部署、或高频小图（如每秒上百张验证码），本地 tesseract 不可替代。
立即学习“go语言免费学习笔记（深入）”；
- 云方案关键点：base64 编码前先压缩图片（
gocv.IMWrite控制 JPEG 质量到 85）、用context.WithTimeout包裹 HTTP 请求、错误时 fallback 到本地降级逻辑 - 百度 OCR 需提前申请
access_token并缓存，别每次请求都重拿；Google Vision API 要启用vision.googleapis.com服务并配置 service account key 文件 - 本地
tesseract的隐性成本常被低估：它吃 CPU，单进程并发高了会排队阻塞；用 goroutine 跑多个exec.Command时，记得限制并发数（如用semaphore），否则可能触发系统 fork 失败
tesseract 进程启动时读不到 tessdata、或是中文包版本和主程序不匹配导致静默失败。建议第一次成功后，把 tesseract --version 和 tesseract --list-langs 的输出结果硬编码进健康检查接口，比任何日志都管用。 
