使用Ocra gem转换Ruby脚本为可执行文件时遭遇UTF-8无效字节序列错误的解决方案咨询

你遇到的是Ocra在Windows环境下处理路径时的UTF-8编码兼容性问题，这在Ruby 3.1+的x64-mingw-ucrt版本中比较常见。下面是几个可行的解决思路：

1. 修复Ocra的编码处理逻辑 #

这个错误是Ocra在转换Windows路径到POSIX格式时，遇到非UTF-8字节序列导致的。你可以手动修改Ocra源码来修复：

• 找到Ocra的执行脚本路径：C:/Ruby31-x64/lib/ruby/gems/3.1.0/gems/ocra-1.3.11/bin/ocra
• 打开文件，定位到第34行的to_posix方法里的tr调用
• 将原代码：

  def to_posix(path)
    path.tr('\\', '/')
  end
  

  修改为：

  def to_posix(path)
    path.encode('UTF-8', 'Windows-1252', invalid: :replace, undef: :replace).tr('\\', '/')
  end
  

• 保存后重新执行 ocra test.rb 即可。这个修改会自动将Windows系统编码的路径转换为UTF-8，避免编码错误。

2. 更换其他Ruby打包工具 #

如果不想修改Ocra源码，可以试试这些成熟的替代工具：

• RubyScript2Exe：对Windows环境支持友好的老牌工具，安装和使用都很简单：

  gem install rubyscript2exe
  rubyscript2exe test.rb
  

• JRuby + Warbler：如果你能接受使用JRuby环境，Warbler可以将Ruby脚本打包成跨平台的exe文件，同时还支持Java生态的依赖。
• rake-compiler：适合需要编译成原生可执行文件的场景，不过需要编写Rake任务来配置打包流程，更适合复杂项目。

3. 切换到非UCRT版本的Ruby #

你当前使用的是x64-mingw-ucrt版本的Ruby，Ocra对这个版本的兼容性还不够完善。可以尝试降级到同版本的x64-mingw32版本Ruby，重新安装Ocra后再进行打包操作，大概率能避开这个编码问题。

额外注意事项 #

• 确保你的脚本路径和文件名都是英文，避免中文或特殊字符，这会减少很多编码相关的坑
• 检查你的测试脚本是否有笔误：你写的是puts "Hello word"，应该是puts "Hello world"，虽然不影响打包，但执行时会输出错误的单词

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