内部变量

-I 指定的路径
环境变量 RUBYLIB 的值
/usr/local/lib/ruby/site_ruby/VERSION        site固有的,取决于VERSION的库
/usr/local/lib/ruby/site_ruby/VERSION/ARCH   site固有的,取决于系统的扩展库
/usr/local/lib/ruby/site_ruby                site固有的库
/usr/local/lib/ruby/VERSION                  标准库
/usr/local/lib/ruby/VERSION/ARCH             标准的,取决于系统的扩展库
.                                            当前目录

上表中的VERSION是表示Ruby版本的字符串,如"1.6"或"1.8"等.ARCH是表示硬件和OS的字符串,如"i686-linux"或"alpha-osf5.1"等.可以从Config::CONFIG['arch']中得到这些信息.

在多数UNIX系统中,编译时的默认路径是"/usr/local/lib/ruby".在mswin32,mingw32,cygwin,bccwin32,mswince这些环境中,是以ruby.dll所在位置为起点的相对路径.而在djgpp,emx(OS/2)中,则是以ruby.exe所在位置为起点的相对路径.

在使用-T 选项启动时,若将$SAFE设为1以上的值的话,则"." (当前目录)不会被纳入加载路径.

如require 'foo'时,将交互搜索.rb和.so.

/usr/local/lib/ruby/site_ruby/VERSION/foo.rb
/usr/local/lib/ruby/site_ruby/VERSION/foo.so
/usr/local/lib/ruby/site_ruby/VERSION/ARCH/foo.rb
/usr/local/lib/ruby/site_ruby/VERSION/ARCH/foo.so
  :
  :

有的系统的共享库扩展名并非.so,此时将自动使用新的扩展名.例如在HP-UX上require 'foo.so'时将搜索foo.sl.因此在Ruby内部,可以一直使用.so.

若想用命令行查看加载路径的话,可以这样

$ ruby -e 'puts $:'

即可.

$"

$LOADED_FEATURES ((<ruby 1.8 特性>))

包含以require加载的文件名的数组.这可以防止require多次加载同一个文件.

$DEBUG

若此值为真则变成调试模式。它由-d选项进行设定。

调试模式与普通的运行有以下不同。

若某线程因发生异常而结束时，整个解释器也将中止工作。这等同于将Thread.abort_on_exception设置为true的效果，但是在调试模式中，即使在脚本中使用 abort_on_exception= 类方法来重置标识也无法取消该效果。

在通常的运行中，若某线程发生了异常却并没有被Thread#join等检测到的话，该线程将被无警告地终止。
不管有没有捕捉到异常，只要它一旦发生就会被报告到 $stderr 。处理会继续进行。

$FILENAME

虚拟文件ARGF中，当前正在读入的(gets方法正在读的)文件名。与ARGF.filename相同。

$:的别名。

标准输入，标准输出，标准错误输出。

ruby 1.8 特性

$stdout, $stderr 是 $defout,$deferr 的别名。($defout, $deferr 已经废止)

$stdout, $stderr的对应对象中必须要有名为write的方法。详细情况请参考defout,deferr。

$stdin同$stdout、$stderr一样，即使没有特定的方法也可以对其赋值。若执行gets等方法时，该方法将被投射到$stdin对应的对象中。(将执行$stdin.gets)

$stdin所对应的对象中应该定义下列方法。(请根据需要取舍)

gets, readline, readlines, getc, readchar, tell, seek,
pos=, rewind, fileno, to_io, eof, each_line, each_byte,
binmode, closed?

例:

$stdin = Object.new
def $stdin.gets
  "foo"
end
p gets

# => "foo"

若想对标准输入、输出、错误输出等进行重定向(redirect)时，可以使用IO#reopen(1.6版也是如此)。例如

$stdout = File.open("/tmp/foo", "w")

写成这样

STDOUT.reopen("/tmp/foo", "w")

就可以了。若想取消重定向时

stdout_sv = STDOUT.dup          # 保存 STDOUT
STDOUT.reopen("/tmp/foo")       # 将 STDOUT 重定向到 /tmp/foo

puts "foo"                      # 输出到 /tmp/foo

STDOUT.flush                    # 必须(?)
STDOUT.reopen(stdout_sv)        # 恢复原状

就可以了。若您不想让重定向影响到子进程的话，只要向$stdout等赋值就足够了。

# 改变输出方法的默认输出对象
$stdout = File.open("/tmp/foo", "w")

puts "foo"

# 取回输出方法的默认输出对象。
$stdout = STDOUT

ruby 1.6 特性: 向$stdin、$stdout、$stderr赋值时，会进行重定向。

ruby 1.7 特性: 暂时修改了重定向的运作方式[ruby-dev:14601]。

$VERBOSE

冗长消息标识。由面向Ruby解释器的-v选项进行设定。

ruby 1.8 特性

警告等级分为三级，分别如下。

nil: 不输出警告
false: 只输出重要警告(默认)
true: 输出所有警告

可以使用命令行选项-W[level]来指定警告等级，分别为-W0、-W1、-W2 (or -W)。指定-v或-w时，等同于-W2。

若设定为nil、false之外的值时，其值为变为true。

$KCODE

Ruby可识别的多字节字符串的编码。变量值为"EUC" "SJIS" "UTF8" "NONE"之一。

当$KCODE的值为"EUC"时，将假定字符串或正则表达式的编码为EUC-JP。同样地，若为"SJIS"时则认定为Shift JIS。若为"UTF8"时则认定为UTF-8。若为"NONE"时，将不会识别多字节字符串。

在向该变量赋值时，只有第1个字节起作用，且不区分大小写字母。"e" "E" 代表 "EUC"，"s" "S" 代表 "SJIS"，"u" "U" 代表 "UTF8"，而"n" "N" 则代表 "NONE"。

默认值为"NONE"。

[参考]

目前$KCODE将对Ruby的下列动作产生影响。

解释器的字句解析器
Regexp的编码标识的默认值
(正则表达式字面值
Regexp.new)
upcase
downcase
swapcase
capitalize
inspect
split
gsub
scan

选项变量

用来显示Ruby解释器命令行信息的变量。其形式为$-?，?的部分是1位选项字符。

$/ 的别名。

若指定了-a时，其值为真。只读变量。

$DEBUG 的别名。

$; 的别名。

若指定了-i[extension]时，它将保存扩展名字符串。否则其值为nil。也可以在脚本中对其进行赋值，此时将在开始读入ARGV中的下一个文件之前进行in-place替换。

$LOAD_PATH 的别名。

$KCODE 的别名。

若指定了-l时，其值为真。只读变量。

若指定了-p时，其值为真。只读变量。

$VERBOSE 的别名。

$-W ((<ruby 1.9 特性>))

返回由-W[level]指定的值。

也就是说，根据$VERBOSE的取值不同

nil: 不输出警告 -> 0
false: 只输出重要警告(默认) -> 1
true: 输出所有警告 -> 2

而返回上述诸值之一。只读变量。