错误排查手册


# 弹窗报错 Cannot find Py_Main() in ……

解决方法1：
下载安装VC运行库，重启系统，测试Umi-OCR能否正常运行。
https://aka.ms/vs/17/release/vc_redist.x64.exe

解决方法2：
使用这个bat文件代替 Umi-OCR.exe 来启动软件。双击它即可。
UmiOCR-data/RUN_GUI.bat
注意1：通过bat启动时，部分功能受限，将无法使用命令行指令和创建快捷方式（开始菜单、开机自启等）。如有需要，请参考后面【手动放置快捷方式】条目。
注意2：不要移动bat的位置。


# 手动放置快捷方式

如果因为某些原因，软件自身无法创建快捷方式；请手动创建并将快捷方式放置到如下目录：

开始菜单目录：
C:\ProgramData\Microsoft\Windows\Start Menu
开机自启目录：
C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup


# 弹窗报错 Failed to create OpenGL context ……

1. 下载运行库：
https://github.com/hiroi-sora/Umi-OCR_v2/files/13167436/opengl32sw_64.zip
2. 解压，将其中的dll文件放置于：
UmiOCR-data/site-packages/PySide2/


# 弹窗报错 Umi-OCR.exe 已停止工作

此问题常见于：软件已经在win10使用过，然后原封不动复制到win7上，导致配置冲突。
删除下述配置文件即可：
UmiOCR-data/.pre_settings