Tesseract训练执行shapeclustering命令时出现“Failed to load font_properties from font_properties”错误的解决方法求助

我之前在跑Tesseract训练流程、执行shapeclustering命令时，也碰到过完全一样的错误！别担心，这个问题核心就是系统找不到正确的font_properties文件，或者文件本身格式有问题，给你几个实用的解决步骤：

• 确认font_properties文件存在且在当前工作目录
  先在命令提示符里执行dir（Windows）或ls（Linux/macOS），看看当前目录下有没有这个文件。如果没有，得手动创建它：
  文件格式非常严格，每行必须是[字体名称] 0 0 0 0 0，比如你训练用的是Block字体，那文件里就写一行：

  block 0 0 0 0 0
  

  这里的五个数字依次对应：粗体、斜体、下划线、删除线、固定宽度，0代表无该属性，1代表有，根据你的实际字体调整就行。

• 检查命令中的文件路径是否正确
  如果你把font_properties放在了其他目录，不能只写-F font_properties，要指定完整路径。比如Windows下可能是：

  shapeclustering -F C:\tesseract_train\font_properties -U unicharset -O block.unicharset block.font.exp0.tr
  

  Linux/macOS下类似：

  shapeclustering -F /home/yourname/tesseract_train/font_properties -U unicharset -O block.unicharset block.font.exp0.tr
  

• Linux/macOS用户检查文件权限
  如果文件确实存在但还是报错，大概率是权限不足，执行下面的命令给文件添加可读权限：

  chmod +r font_properties
  

小提醒 #

创建font_properties时，一定要用纯文本编辑器（比如记事本、VS Code），别用Word这类带格式的编辑器，避免生成隐形字符导致Tesseract读取失败。

内容的提问来源于stack exchange，提问作者Pravin