在 Windows 的 cmd 环境下跑 Ruby，最让人头疼的，往往就是中文乱码和OpenSSL 支持缺失。这两个问题看似独立，却经常同时出现，让不少开发者卡在入门阶段。

下面就分别拆解这两个问题，并把对应解决方案讲清楚。

中文乱码的根源与应对

cmd 默认的代码页通常是 936（简体中文），但 Ruby 脚本往往以 UTF-8 编码保存。

这会导致读取和输出时出现字符集错乱。最简单的第一步，是先将 cmd 代码页切换为 936：

chcp 936

先解决脚本读取乱码

接下来，强制 Ruby 以 UTF-8 格式读取脚本文件。

只需要在文件开头加上注释：

# encoding: UTF-8

这样一来，Ruby 就会用 UTF-8 编码载入文件，避免读取阶段的中文乱码。

输出阶段仍可能乱码

即使读取正常，输出时问题仍然可能存在。原因在于 cmd 窗口的编码与 UTF-8 不兼容，直接 puts 中文时，仍可能显示为乱码。

早期有开发者会通过第三方库 iconv 做编码转换：

require 'iconv'
cov = Iconv.new('gbk', 'utf-8')
puts cov.iconv("北京奥运会!")

这种方式虽然可行，但依赖外部库，而且在现代 Ruby 版本中已被废弃。

更推荐的处理方式

更推荐的做法是：不要在 Ruby 程序内部硬编码中文，注释除外。

如果确实需要显示中文，可以优先考虑以下方式：

• 将输出重定向到文件；

• 使用支持 UTF-8 的终端；

• 如 PowerShell、Windows Terminal 配合 UTF-8 代码页。

Ruby 不支持 OpenSSL 的解决之路

另一类常见问题，通常发生在安装 Rails 或需要 SSL 加密的场景。

例如在 RHEL 5.4 x86_64 上安装 Rails 时，系统会提示 Ruby 不支持 OpenSSL。遇到这种情况，就需要手动编译 OpenSSL 扩展。

先检查依赖是否完整

进入 Ruby 源码目录下的 ext/openssl，执行 ruby extconf.rb 检查依赖。

如果出现以下错误：

checking for openssl/ssl.h... no
Makefile wasn't created. Fix the errors above.

这说明系统没有安装 OpenSSL 开发头文件。

此时可从 openssl.org 下载 openssl-0.9.8k.tar.gz，解压后编译安装：

./configure && make && make install

重新指定 OpenSSL 路径

安装完成后，重新运行 extconf.rb，并显式指定 OpenSSL 的 include 和 lib 路径：

ruby extconf.rb --with-openssl-include=/usr/local/ssl/include/ --with-openssl-lib=/usr/local/ssl/lib

这一步通常可以让配置阶段顺利通过。

make 阶段的经典错误

不过在 make 时，仍可能遇到另一个经典错误：

/usr/bin/ld: /usr/local/ssl/lib/libssl.a: relocation R_X86_64_32 against `a local symbol' cannot be used when making a shared object; recompile with -fPIC

这个报错已经说明了原因：静态库 libssl.a 在编译时没有启用位置无关代码（-fPIC），因此无法被动态链接。

正确解决办法

解决方法是重新编译 OpenSSL，并加上 -fPIC 参数：

./configure -fPIC
make
make install

完成后，再回到 ext/openssl 目录，重新执行 ruby extconf.rb 和 make。

正常情况下，就可以顺利编译出 openssl.so 扩展。

总结

以上两个问题，本质上都是环境配置中的兼容性陷阱。

• 中文乱码，核心在于编码不一致；

• OpenSSL 支持缺失，关键在于依赖完整性和编译参数 -fPIC。

只要掌握编码转换机制，以及 OpenSSL 编译时的 -fPIC 细节，就能顺利绕过这些问题。

技术在不断迭代。像 iconv 这样的老办法虽然还能用，但更推荐使用现代终端和标准的 UTF-8 工作流。

《夸克》非常好用的免费AI浏览器

下载APP查看