在 Windows 上安装 ruby-oci8（用于连接 Oracle 数据库）需要以下步骤：

1. 安装 Oracle Instant Client

ruby-oci8 依赖 Oracle 的 Instant Client，你需要下载并安装它。

步骤：

1. 访问 Oracle Instant Client 下载页面。
2. 下载 Basic Package 和 SDK Package（推荐 19c 或 21c 版本）。
3. 解压这两个压缩包到同一个目录（如 C:\oracle\instantclient_19_11）。
4. 将该目录添加到 环境变量：
   • 系统变量 → Path，添加 C:\oracle\instantclient_19_11
   • 新增环境变量： TNS_ADMIN = C:\oracle\instantclient_19_11
   • 重启电脑 以生效。

2. 安装 Ruby 和 DevKit

1. 从 RubyInstaller 官网 下载 Ruby+DevKit 版本（推荐 3.0 或 2.7）。
2. 安装时勾选 Add Ruby to PATH。
3. 运行 ridk install，选择 MSYS2 基础工具。

3. 安装 ruby-oci8

打开终端（cmd 或 PowerShell），运行：

gem install ruby-oci8

如果你的 Oracle Instant Client 目录没有正确配置，可能会遇到错误。这时可以使用：

gem install ruby-oci8 -- --with-instant-client=C:\oracle\instantclient_19_11

4. 验证安装

安装完成后，在 irb 里测试：

require 'oci8'
puts OCI8::oracle_client_version

如果输出 19.11 或 21.x 版本号，则安装成功。

可能遇到的问题

1. 找不到 oci.dll

   • 确保 C:\oracle\instantclient_19_11 在 Path 里。
   • 运行： sh set PATH=C:\oracle\instantclient_19_11;%PATH%
   • 重新安装 ruby-oci8。

2. ruby-oci8 版本不兼容

   • ruby-oci8 可能不支持 Ruby 3.1+，建议用 Ruby 3.0 或 2.7。

3. msvcr100.dll 缺失

   • 安装 Microsoft Visual C++ 2010 Redistributable。

这样就能在 Windows 上成功安装 ruby-oci8 了！🚀