Ruby 环境变量

在 Ruby 中，环境变量 是操作系统提供的一组键值对，可以用来配置程序运行时的行为，例如路径、编码设置或自定义参数。Ruby 提供了简单的方式来访问和操作这些变量。以下是关于 Ruby 环境变量的详细说明，包括如何获取、设置以及常见用法。

1. 什么是环境变量？

环境变量是操作系统级别的变量，通常用来存储配置信息。例如：

• PATH：指定可执行文件的搜索路径。
• HOME：用户的家目录。
• RUBYLIB：Ruby 的额外库路径。

在 Ruby 中，环境变量通过 ENV 对象访问，这是一个类似哈希的全局对象。

2. 获取环境变量

使用 ENV 对象可以读取当前的环境变量。

示例：获取单个环境变量

puts ENV["HOME"]    # 输出用户家目录，例如 /home/user 或 C:\Users\User
puts ENV["PATH"]    # 输出 PATH 环境变量
puts ENV["RUBYLIB"] # 输出 Ruby 的额外库路径（如果已设置）

示例：列出所有环境变量

ENV.each do |key, value|
  puts "#{key}: #{value}"
end

这会打印所有环境变量及其值，例如：

HOME: /home/user
PATH: /usr/local/bin:/usr/bin:/bin
...

检查是否存在

if ENV["MY_VAR"]
  puts "MY_VAR 已设置: #{ENV["MY_VAR"]}"
else
  puts "MY_VAR 未设置"
end

3. 设置环境变量

在 Ruby 中，可以通过 ENV 修改当前进程的环境变量，但这些更改仅在程序运行期间有效，不会影响系统全局环境。

示例：设置环境变量

ENV["MY_VAR"] = "Hello, Ruby!"
puts ENV["MY_VAR"]  # 输出：Hello, Ruby!

示例：临时修改 PATH

original_path = ENV["PATH"]
ENV["PATH"] = "#{original_path};C:\my\new\path"
puts ENV["PATH"]

注意事项

• ENV 修改只影响当前 Ruby 进程及其子进程。
• 要永久修改环境变量，需要在操作系统层面设置（例如编辑 .bashrc 或 Windows 的系统设置）。

4. 删除环境变量

可以用 ENV.delete 删除某个环境变量。

ENV["MY_VAR"] = "Test"
puts ENV["MY_VAR"]  # 输出：Test
ENV.delete("MY_VAR")
puts ENV["MY_VAR"]  # 输出：nil

5. 常见与 Ruby 相关的环境变量

以下是 Ruby 开发中常用的环境变量：

检查示例

puts "Gem 路径: #{ENV["GEM_PATH"]}"
puts "Ruby 选项: #{ENV["RUBYOPT"]}"

6. 在命令行中设置环境变量

运行 Ruby 脚本时，可以通过命令行临时设置环境变量。

Linux/macOS

MY_VAR="你好" ruby -e 'puts ENV["MY_VAR"]'

输出：你好

Windows (CMD)

set MY_VAR=你好
ruby -e "puts ENV['MY_VAR']"

输出：你好

Windows (PowerShell)

$env:MY_VAR = "你好"
ruby -e "puts ENV['MY_VAR']"

永久设置

• Linux/macOS：编辑 ~/.bashrc 或 ~/.zshrc：

  export MY_VAR="你好"

然后运行 source ~/.bashrc。

• Windows：通过“系统属性” -> “环境变量” 添加。

7. 处理中文环境变量

如果环境变量包含中文，确保编码正确：

• Linux/macOS：默认 UTF-8，通常无需额外处理。
• Windows：CMD 默认可能是 GBK，需切换到 UTF-8：

  chcp 65001
  set MY_VAR=你好
  ruby -e "puts ENV['MY_VAR']"

• 在 Ruby 中检查编码：

  value = ENV["MY_VAR"]
  puts value.encoding  # 应为 UTF-8

如果乱码，可以强制转换：

value = ENV["MY_VAR"].encode("UTF-8", "GBK")  # 从 GBK 转为 UTF-8
puts value

8. 实践示例

示例 1：根据环境变量打招呼

# greet.rb
name = ENV["USER_NAME"] || "陌生人"
puts "你好，#{name}！"

运行：

USER_NAME=张三 ruby greet.rb

输出：你好，张三！

示例 2：动态加载路径

if ENV["CUSTOM_LIB"]
  $LOAD_PATH << ENV["CUSTOM_LIB"]
end
require "my_script"

9. 注意事项

• 安全性：不要将敏感信息（如密码）直接存储在环境变量中，建议使用加密或配置文件。
• 跨平台：不同操作系统对环境变量的处理可能不同（例如大小写敏感性，Windows 不敏感，Linux 敏感）。
• 调试：用 ruby -e 'p ENV' 快速查看所有环境变量。

下一步

• 试试代码：告诉我你的操作系统，我可以帮你设计一个使用环境变量的例子。
• 解决问题：如果有环境变量相关的疑问（比如获取不到值），告诉我具体情况。
• 深入学习：想了解如何在 Rails 或其他框架中使用环境变量吗？我可以继续讲解。

你现在想做什么？测试某个环境变量，还是有具体问题？