技术分享 Windows 上安装 ruby-oci8

kaka · 2025年02月17日 · 20 次阅读

在 Windows 上安装 ruby-oci8(用于连接 Oracle 数据库)需要以下步骤:


1. 安装 Oracle Instant Client

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

步骤:

  1. 访问 Oracle Instant Client 下载页面
  2. 下载 Basic PackageSDK 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

打开终端(cmdPowerShell),运行:

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.1121.x 版本号,则安装成功。


可能遇到的问题

  1. 找不到 oci.dll

    • 确保 C:\oracle\instantclient_19_11Path 里。
    • 运行: sh set PATH=C:\oracle\instantclient_19_11;%PATH%
    • 重新安装 ruby-oci8
  2. ruby-oci8 版本不兼容

    • ruby-oci8 可能不支持 Ruby 3.1+,建议用 Ruby 3.02.7
  3. msvcr100.dll 缺失


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

暂无回复。
需要 登录 后方可回复