零后端玩转OCRTesseract.js 浏览器图片文字识别实战指南【免费下载链接】tesseract.jsPure Javascript OCR for more than 100 Languages 项目地址: https://gitcode.com/GitHub_Trending/te/tesseract.js你是否遇到过这样的需求用户上传一张带文字的图片你想在网页里直接提取出里面的内容又或者你在做一个小工具站想把图片转文字做成亮点功能却不想为了一个识别接口去搭服务器、买云服务、调 API 额度Tesseract.js 就是为这个场景而生的——它是纯 JavaScript 实现的 OCR 引擎支持 100 多种语言的文字识别可以直接跑在浏览器里。这篇文章不打算讲枯燥的原理而是用一套先跑通、再调优、再避坑的思路带你一步步把浏览器端图片文字识别能力集成进自己的页面。全程不需要后端、不需要安装任何本地环境一个 HTML 文件就够了。为什么我劝你把 OCR 放在浏览器里做先说结论对于绝大多数网页里识别图片文字的需求纯前端方案比后端方案更省心。零部署成本后端 OCR 通常要装 Tesseract 本体、处理系统依赖、维护服务进程而 Tesseract.js 通过 CDN 引入后刷新页面即用。隐私友好图片在用户本地完成识别不需要上传到你的服务器身份证、票据这类敏感信息更安全。无并发压力识别计算发生在用户浏览器里你的服务器完全不参与天然不存在接口被打爆的问题。响应够快省去了上传→排队→识别→回传的网络往返本地算完直接出结果。当然它也有代价首次加载需要下载核心引擎和语言包几 MB 级别且识别速度受用户设备性能影响。但配合合理的缓存与调度策略后面会讲体验完全可以接受。先花 30 秒搞懂它在背后做了什么不用深入源码你只需要知道三样东西在配合工作Worker 实例负责执行识别的工人创建一次可反复使用语言包traineddata决定它能认哪些语言按需加载核心引擎tesseract.js-core真正跑识别算法的底层库。你的角色就是创建 Worker → 喂图片 → 收文字。就这么简单。上面这张就是项目自带的经典测试图白底黑字的印刷体段落是检验识别器是否开箱可用的标准样例。从零跑通第一段识别代码下面这段流程请打开编辑器跟着做全程不超过三分钟。第一步建一个空 HTML 页面新建index.html什么都不用配置直接往里写。第二步引入 CDN 资源在head里加一行 script把 Tesseract.js 的浏览器构建版拉进来script srchttps://cdn.jsdelivr.net/npm/tesseract.js5/dist/tesseract.min.js/script注意这里锁定了5主版本号避免未来大版本升级导致 API 变化、线上代码失效。第三步三行核心代码让图片开口说话下面这段代码解决的核心问题是用户选一张图页面立刻把里面的文字识别出来并展示。input typefile iduploader acceptimage/* script // 创建 Worker只需一次后续所有识别都复用它 const worker await Tesseract.createWorker(eng, 1, { logger: m console.log(进度: ${m.status} ${(m.progress * 100).toFixed(1)}%) }); document.getElementById(uploader).addEventListener(change, async (e) { const file e.target.files[0]; if (!file) return; // 喂入图片取出识别文本 const { data: { text } } await worker.recognize(file); alert(识别结果\n${text}); }); /script几个关键点createWorker(eng, 1, {...})的三个参数分别是语言这里用英文、OEM 引擎模式1 表示 LSTM 引擎和可选配置这里只加了进度日志Worker 一定放在事件回调外面创建否则每选一张图就重建一次白白浪费加载时间recognize()返回的data.text就是识别出来的整段文字。在浏览器里打开这个页面选一张清晰的印刷体图片控制台会依次看到loading tesseract core、initializing api、recognizing text等进度最后弹窗显示结果。动图展示的就是典型的完整流程初始化 → 加载语言包 → 处理图片 → 输出文本全程在浏览器本地完成。让识别结果更准三个立竿见影的调优开关跑通只是开始真实场景里图片千奇百怪下面三个参数能显著提升准确率而且都是几行代码的事。限定识别区域当图片里只有一小块区域有文字时比如截图的某一行、表单的某个格子把识别范围圈出来既快又准。下面这段代码解决的是只识别图片左上角 300×200 区域的问题const { data: { text } } await worker.recognize(imageFile, { rectangle: { left: 0, top: 0, width: 300, height: 200 } });rectangle接收left / top / width / height四个坐标值单位是像素。切换版面识别模式PSMTesseract 内置了十几种版面分析模式通过Tesseract.PSM常量切换。针对只有一行文字的图片默认的整页分析反而容易出错改成单行模式更稳。下面这段代码解决的是识别单行文字/验证码场景await worker.setParameters({ tessedit_pageseg_mode: Tesseract.PSM.SINGLE_LINE });常用模式速查常量适用场景PSM.AUTO整页混合版面默认推荐PSM.SINGLE_BLOCK一段连续文字块PSM.SINGLE_LINE单独一行文字PSM.SINGLE_WORD单个单词PSM.SPARSE_TEXT文字稀疏、无规则排版用白名单约束字符集当你知道图片里只会出现特定字符时比如只含数字的金额、只含字母的编号白名单能大幅减少误判。下面这段代码解决的是只识别数字的问题await worker.setParameters({ tessedit_char_whitelist: 0123456789 });注意白名单是按字符集限制不是按正则匹配适合字符种类可控的场景。中文英文一起认多语言识别其实很简单Tesseract.js 内置 100 多种语言的语言包chi_sim简体中文、chi_tra繁体中文、eng英文等都可以自由组合。下面这段代码解决的是中英文混排图片的识别// 中英混合识别语言之间用 连接 const worker await Tesseract.createWorker(chi_simeng, 1, { logger: m console.log(m) }); const ret await worker.recognize(mixed-language.png); console.log(识别结果:, ret.data.text); await worker.terminate(); // 用完记得释放资源两个使用提示每加载一种语言就要额外下载一份语言包按需加载别把所有语言一次性塞进去项目仓库的docs/tesseract_lang_list.md里有一份完整的语言代码清单需要哪种照着抄即可。批量处理几十张图用 Scheduler 排队并行单 Worker 逐张识别在大批量场景下会慢得让人抓狂。Tesseract.js 提供了 Scheduler调度器可以把多个 Worker 组织成一个工人池自动把任务分发下去并行执行。下面这段代码解决的是多张图片并行识别、整体提速的问题// 创建调度器 const scheduler Tesseract.createScheduler(); // 准备 4 个 Worker全部挂到调度器下 for (let i 0; i 4; i) { const worker await Tesseract.createWorker(eng); scheduler.addWorker(worker); } // 批量提交任务Promise.all 等待全部完成 const results await Promise.all( imageFiles.map(file scheduler.addJob(recognize, file)) ); results.forEach(r console.log(r.data.text)); await scheduler.terminate(); // 会连带终止所有 Worker关于并行数的经验值Worker 数量建议不超过 CPU 核心数开太多反而会因为线程切换和内存占用拖慢速度。项目文档docs/performance.md里有更详细的性能对比数据简单说就是 4 Worker 并行通常能比单 Worker 快 3 倍左右。像上面这种结构化的账单表格图正是批量识别的典型应用——票据扫描、报表录入、发票归档都属于它的舒适区。三个高频坑提前帮你踩平以下三个问题在社区里被问得最多这里直接给可复制的解法。坑一远程图片跨域识别直接报错图片在别的域名下直接传给recognize()会被浏览器的跨域策略拦下来。两种解法任选解法 A后端代理——把图片请求转发到你自己的服务器绕开跨域。解法 B转成 Base64 再喂给 Worker。下面这段代码解决的是跨域图片无法直接识别的问题async function imageToBase64(url) { const resp await fetch(url, { mode: cors }); const blob await resp.blob(); return new Promise((resolve) { const reader new FileReader(); reader.onloadend () resolve(reader.result); reader.readAsDataURL(blob); }); } const base64 await imageToBase64(https://example.com/pic.jpg); const { data: { text } } await worker.recognize(base64);坑二手机端又慢又卡移动端性能瓶颈主要在图片尺寸和计算量两个优化思路上传前压缩用 Canvas 把图片最长边压到 800px 以内再识别速度立竿见影关闭多余计算比如设置preserve_interword_spaces: 0减少空格推断开销或用前面讲的 PSM 单行模式缩小分析范围。下面这段代码解决的是移动端大图识别前先压缩的问题async function shrinkImage(file, maxSide 800) { const bitmap await createImageBitmap(file); const scale Math.min(1, maxSide / Math.max(bitmap.width, bitmap.height)); const canvas document.createElement(canvas); canvas.width Math.round(bitmap.width * scale); canvas.height Math.round(bitmap.height * scale); const ctx canvas.getContext(2d); ctx.drawImage(bitmap, 0, 0, canvas.width, canvas.height); return canvas.toDataURL(image/jpeg, 0.85); }另外别忘了Tesseract.js 本身就是跑在 Web Worker 里的不会阻塞 UI 线程这也是它能扛住较大图片的原因之一。坑三语言包加载超时或失败网络波动时语言包可能下载失败。解决办法是给资源指定本地路径实现离线兜底。下面这段代码解决的是核心文件与 Worker 脚本走本地、避免依赖远程 CDN的问题const worker await Tesseract.createWorker(eng, 1, { corePath: /local-tesseract-core, // 本地核心引擎目录 workerPath: /local-worker.js // 本地 Worker 脚本 });完整的离线部署方案可以看项目里的docs/local-installation.md把引擎、语言包、Worker 脚本都放到自己的静态目录里彻底摆脱外部依赖。总结一份可以直接抄的最佳实践清单最后把全文的干货浓缩成六条直接对着检查#实践要点为什么1CDN 链接锁定主版本号如5避免自动升级破坏兼容性2全局只维护一个 Worker 实例省去反复加载引擎与语言包的开销3语言按需加载、用完即组合避免白下载不需要的语言包4批量任务用 SchedulerWorker 数 ≈ CPU 核心数并行提速且不拖垮设备5跨域图片先转 Base64 或走代理绕开浏览器安全策略6敏感图片识别前先在前端做预处理比如模糊处理身份证号再交给 OCR更多进阶内容可以翻阅项目文档完整 API 参考在docs/api.md常见问答在docs/faq.md各种可直接运行的示例在examples/browser/目录下。现在就动手你的下一步纸上谈兵不如跑一个真项目。建议你按这个顺序来先照着本文三步走代码建一个最小 demo上传一张自己的照片试水然后试着给 Worker 加语言包、切 PSM 模式感受不同参数下的识别差异最后把批量场景换成 Scheduler 并行版对比一下耗时。整个过程不需要装任何东西浏览器就是你唯一的运行环境。当第一行识别文字从你自己写的页面里弹出来时那种成就感值得你立刻打开编辑器试试。→→去把图片变成文字吧【免费下载链接】tesseract.jsPure Javascript OCR for more than 100 Languages 项目地址: https://gitcode.com/GitHub_Trending/te/tesseract.js创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 零后端玩转OCR：Tesseract.js 浏览器图片文字识别实战指南
零后端玩转OCRTesseract.js 浏览器图片文字识别实战指南【免费下载链接】tesseract.jsPure Javascript OCR for more than 100 Languages 项目地址: https://gitcode.com/GitHub_Trending/te/tesseract.js你是否遇到过这样的需求用户上传一张带文字的图片你想在网页里直接提取出里面的内容又或者你在做一个小工具站想把图片转文字做成亮点功能却不想为了一个识别接口去搭服务器、买云服务、调 API 额度Tesseract.js 就是为这个场景而生的——它是纯 JavaScript 实现的 OCR 引擎支持 100 多种语言的文字识别可以直接跑在浏览器里。这篇文章不打算讲枯燥的原理而是用一套先跑通、再调优、再避坑的思路带你一步步把浏览器端图片文字识别能力集成进自己的页面。全程不需要后端、不需要安装任何本地环境一个 HTML 文件就够了。为什么我劝你把 OCR 放在浏览器里做先说结论对于绝大多数网页里识别图片文字的需求纯前端方案比后端方案更省心。零部署成本后端 OCR 通常要装 Tesseract 本体、处理系统依赖、维护服务进程而 Tesseract.js 通过 CDN 引入后刷新页面即用。隐私友好图片在用户本地完成识别不需要上传到你的服务器身份证、票据这类敏感信息更安全。无并发压力识别计算发生在用户浏览器里你的服务器完全不参与天然不存在接口被打爆的问题。响应够快省去了上传→排队→识别→回传的网络往返本地算完直接出结果。当然它也有代价首次加载需要下载核心引擎和语言包几 MB 级别且识别速度受用户设备性能影响。但配合合理的缓存与调度策略后面会讲体验完全可以接受。先花 30 秒搞懂它在背后做了什么不用深入源码你只需要知道三样东西在配合工作Worker 实例负责执行识别的工人创建一次可反复使用语言包traineddata决定它能认哪些语言按需加载核心引擎tesseract.js-core真正跑识别算法的底层库。你的角色就是创建 Worker → 喂图片 → 收文字。就这么简单。上面这张就是项目自带的经典测试图白底黑字的印刷体段落是检验识别器是否开箱可用的标准样例。从零跑通第一段识别代码下面这段流程请打开编辑器跟着做全程不超过三分钟。第一步建一个空 HTML 页面新建index.html什么都不用配置直接往里写。第二步引入 CDN 资源在head里加一行 script把 Tesseract.js 的浏览器构建版拉进来script srchttps://cdn.jsdelivr.net/npm/tesseract.js5/dist/tesseract.min.js/script注意这里锁定了5主版本号避免未来大版本升级导致 API 变化、线上代码失效。第三步三行核心代码让图片开口说话下面这段代码解决的核心问题是用户选一张图页面立刻把里面的文字识别出来并展示。input typefile iduploader acceptimage/* script // 创建 Worker只需一次后续所有识别都复用它 const worker await Tesseract.createWorker(eng, 1, { logger: m console.log(进度: ${m.status} ${(m.progress * 100).toFixed(1)}%) }); document.getElementById(uploader).addEventListener(change, async (e) { const file e.target.files[0]; if (!file) return; // 喂入图片取出识别文本 const { data: { text } } await worker.recognize(file); alert(识别结果\n${text}); }); /script几个关键点createWorker(eng, 1, {...})的三个参数分别是语言这里用英文、OEM 引擎模式1 表示 LSTM 引擎和可选配置这里只加了进度日志Worker 一定放在事件回调外面创建否则每选一张图就重建一次白白浪费加载时间recognize()返回的data.text就是识别出来的整段文字。在浏览器里打开这个页面选一张清晰的印刷体图片控制台会依次看到loading tesseract core、initializing api、recognizing text等进度最后弹窗显示结果。动图展示的就是典型的完整流程初始化 → 加载语言包 → 处理图片 → 输出文本全程在浏览器本地完成。让识别结果更准三个立竿见影的调优开关跑通只是开始真实场景里图片千奇百怪下面三个参数能显著提升准确率而且都是几行代码的事。限定识别区域当图片里只有一小块区域有文字时比如截图的某一行、表单的某个格子把识别范围圈出来既快又准。下面这段代码解决的是只识别图片左上角 300×200 区域的问题const { data: { text } } await worker.recognize(imageFile, { rectangle: { left: 0, top: 0, width: 300, height: 200 } });rectangle接收left / top / width / height四个坐标值单位是像素。切换版面识别模式PSMTesseract 内置了十几种版面分析模式通过Tesseract.PSM常量切换。针对只有一行文字的图片默认的整页分析反而容易出错改成单行模式更稳。下面这段代码解决的是识别单行文字/验证码场景await worker.setParameters({ tessedit_pageseg_mode: Tesseract.PSM.SINGLE_LINE });常用模式速查常量适用场景PSM.AUTO整页混合版面默认推荐PSM.SINGLE_BLOCK一段连续文字块PSM.SINGLE_LINE单独一行文字PSM.SINGLE_WORD单个单词PSM.SPARSE_TEXT文字稀疏、无规则排版用白名单约束字符集当你知道图片里只会出现特定字符时比如只含数字的金额、只含字母的编号白名单能大幅减少误判。下面这段代码解决的是只识别数字的问题await worker.setParameters({ tessedit_char_whitelist: 0123456789 });注意白名单是按字符集限制不是按正则匹配适合字符种类可控的场景。中文英文一起认多语言识别其实很简单Tesseract.js 内置 100 多种语言的语言包chi_sim简体中文、chi_tra繁体中文、eng英文等都可以自由组合。下面这段代码解决的是中英文混排图片的识别// 中英混合识别语言之间用 连接 const worker await Tesseract.createWorker(chi_simeng, 1, { logger: m console.log(m) }); const ret await worker.recognize(mixed-language.png); console.log(识别结果:, ret.data.text); await worker.terminate(); // 用完记得释放资源两个使用提示每加载一种语言就要额外下载一份语言包按需加载别把所有语言一次性塞进去项目仓库的docs/tesseract_lang_list.md里有一份完整的语言代码清单需要哪种照着抄即可。批量处理几十张图用 Scheduler 排队并行单 Worker 逐张识别在大批量场景下会慢得让人抓狂。Tesseract.js 提供了 Scheduler调度器可以把多个 Worker 组织成一个工人池自动把任务分发下去并行执行。下面这段代码解决的是多张图片并行识别、整体提速的问题// 创建调度器 const scheduler Tesseract.createScheduler(); // 准备 4 个 Worker全部挂到调度器下 for (let i 0; i 4; i) { const worker await Tesseract.createWorker(eng); scheduler.addWorker(worker); } // 批量提交任务Promise.all 等待全部完成 const results await Promise.all( imageFiles.map(file scheduler.addJob(recognize, file)) ); results.forEach(r console.log(r.data.text)); await scheduler.terminate(); // 会连带终止所有 Worker关于并行数的经验值Worker 数量建议不超过 CPU 核心数开太多反而会因为线程切换和内存占用拖慢速度。项目文档docs/performance.md里有更详细的性能对比数据简单说就是 4 Worker 并行通常能比单 Worker 快 3 倍左右。像上面这种结构化的账单表格图正是批量识别的典型应用——票据扫描、报表录入、发票归档都属于它的舒适区。三个高频坑提前帮你踩平以下三个问题在社区里被问得最多这里直接给可复制的解法。坑一远程图片跨域识别直接报错图片在别的域名下直接传给recognize()会被浏览器的跨域策略拦下来。两种解法任选解法 A后端代理——把图片请求转发到你自己的服务器绕开跨域。解法 B转成 Base64 再喂给 Worker。下面这段代码解决的是跨域图片无法直接识别的问题async function imageToBase64(url) { const resp await fetch(url, { mode: cors }); const blob await resp.blob(); return new Promise((resolve) { const reader new FileReader(); reader.onloadend () resolve(reader.result); reader.readAsDataURL(blob); }); } const base64 await imageToBase64(https://example.com/pic.jpg); const { data: { text } } await worker.recognize(base64);坑二手机端又慢又卡移动端性能瓶颈主要在图片尺寸和计算量两个优化思路上传前压缩用 Canvas 把图片最长边压到 800px 以内再识别速度立竿见影关闭多余计算比如设置preserve_interword_spaces: 0减少空格推断开销或用前面讲的 PSM 单行模式缩小分析范围。下面这段代码解决的是移动端大图识别前先压缩的问题async function shrinkImage(file, maxSide 800) { const bitmap await createImageBitmap(file); const scale Math.min(1, maxSide / Math.max(bitmap.width, bitmap.height)); const canvas document.createElement(canvas); canvas.width Math.round(bitmap.width * scale); canvas.height Math.round(bitmap.height * scale); const ctx canvas.getContext(2d); ctx.drawImage(bitmap, 0, 0, canvas.width, canvas.height); return canvas.toDataURL(image/jpeg, 0.85); }另外别忘了Tesseract.js 本身就是跑在 Web Worker 里的不会阻塞 UI 线程这也是它能扛住较大图片的原因之一。坑三语言包加载超时或失败网络波动时语言包可能下载失败。解决办法是给资源指定本地路径实现离线兜底。下面这段代码解决的是核心文件与 Worker 脚本走本地、避免依赖远程 CDN的问题const worker await Tesseract.createWorker(eng, 1, { corePath: /local-tesseract-core, // 本地核心引擎目录 workerPath: /local-worker.js // 本地 Worker 脚本 });完整的离线部署方案可以看项目里的docs/local-installation.md把引擎、语言包、Worker 脚本都放到自己的静态目录里彻底摆脱外部依赖。总结一份可以直接抄的最佳实践清单最后把全文的干货浓缩成六条直接对着检查#实践要点为什么1CDN 链接锁定主版本号如5避免自动升级破坏兼容性2全局只维护一个 Worker 实例省去反复加载引擎与语言包的开销3语言按需加载、用完即组合避免白下载不需要的语言包4批量任务用 SchedulerWorker 数 ≈ CPU 核心数并行提速且不拖垮设备5跨域图片先转 Base64 或走代理绕开浏览器安全策略6敏感图片识别前先在前端做预处理比如模糊处理身份证号再交给 OCR更多进阶内容可以翻阅项目文档完整 API 参考在docs/api.md常见问答在docs/faq.md各种可直接运行的示例在examples/browser/目录下。现在就动手你的下一步纸上谈兵不如跑一个真项目。建议你按这个顺序来先照着本文三步走代码建一个最小 demo上传一张自己的照片试水然后试着给 Worker 加语言包、切 PSM 模式感受不同参数下的识别差异最后把批量场景换成 Scheduler 并行版对比一下耗时。整个过程不需要装任何东西浏览器就是你唯一的运行环境。当第一行识别文字从你自己写的页面里弹出来时那种成就感值得你立刻打开编辑器试试。→→去把图片变成文字吧【免费下载链接】tesseract.jsPure Javascript OCR for more than 100 Languages 项目地址: https://gitcode.com/GitHub_Trending/te/tesseract.js创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考