Ruby 新闻更新

Ruby 3.2.11 已发布

Fri, 27 Mar 2026 00:00:00 +0000

Ruby 3.2.11 已发布。此版本包括了处理 CVE-2026-27820 的 zlib gem 更新。

此版本是 Ruby 3.2 系列的最后版本。我们将不会再发布 Ruby 3.2 系列的后续更新，包括安全补丁。

我们建议您更新到 Ruby 3.4 或 4.0。

下载

https://cache.ruby-lang.org/pub/ruby/3.2/ruby-3.2.11.tar.gz

文件大小: 19984344
SHA1: 9534a3aa08d2ccb4d3c50b1301b2da9a9b91c4ab
SHA256: b3eeabd6636f334531db3ffdc3229eb05e524740e6c84fdc043720573cf2f8b2
SHA512: 95896bbf519604da0dc3d82066ac92c3f661b2ee9ffd8e2c9effce4773677445f1dcc43b05539050024b57f4f94f43984a734a03015ac6e29679e79d5a093a67

https://cache.ruby-lang.org/pub/ruby/3.2/ruby-3.2.11.tar.xz

文件大小: 14695828
SHA1: 501cecc15ba079087967888ae455d62e5886fbc1
SHA256: c13aec0c206725d5d356acbae6e5fd8bffd92dc325aec14fd5dd7795d4b763d2
SHA512: 418739d476d34e2467e7f1ee60ff63a1969a362b49871bdc488676c1ac7d28b198deee85e2bd951a23f5b0e8425bc89ca59d5c8cb8415fa5ed835555e3d3af8d

https://cache.ruby-lang.org/pub/ruby/3.2/ruby-3.2.11.zip

文件大小: 24594356
SHA1: 7e84c9433f32a758da123d3b5532cc632d19d503
SHA256: 08ab90aa4ada9268e96aa47fb6c3a77fdb3b2f792f2671053e3b55a6141618ce
SHA512: 133d63cd9bb7c9fe38eecd18c996013de0a56fef09c89c42f4fc9c383f09ab4ab3b0b31edbadd1fd1aaa797fbb9c86128ded51c6e5263cd3225754e714b3d195

发布说明

自从 2022 年 12 月 25 日发布 Ruby 3.2.0 以来，对 Ruby 3.2 系列的支持已超过 3 年。

感谢在 Ruby 3.2 系列的整个生命周期中，为之付出贡献的所有提交者、开发者和用户。

由 hsbt 发表于 2026-03-27
翻译： GAO Jun

Ruby 3.3.11 已发布

Thu, 26 Mar 2026 00:00:00 +0000

Ruby 3.3.11 已发布。此版本包括了处理 CVE-2026-27820 的 zlib gem 更新，以及一些其他问题补丁。

详情可参考 GitHub 发布说明。

此版本是 Ruby 3.3 系列的最后一个正常维护版本。此后，Ruby 3.3 将进入安全维护阶段。安全维护阶段中，将不再提供普通的问题补丁，只会提供安全补丁以及修复严重的构建问题。

安全维护阶段将持续一年，即持续至 2027 年 3 月。此后，Ruby 3.3 的官方支持将终止。我们建议您迁移到 Ruby 3.4 或 4.0。

下载

https://cache.ruby-lang.org/pub/ruby/3.3/ruby-3.3.11.tar.gz

文件大小: 21483089
SHA1: 7f18e7e74ab64c5b159a8dfe8da3cc019b32bdb6
SHA256: 59f0fafb1a59a05dc3765117af3fa68e153eb48254708549f321c1e9e078d7a0
SHA512: effbcffce1cad4fa7158ce9159b6109a92e88c29f5d33151c2ec609c54fe24b747354b0e722e0fefe8164700acb2d650b8c65aad0e17e3dec2c26969a44fc524

https://cache.ruby-lang.org/pub/ruby/3.3/ruby-3.3.11.tar.xz

文件大小: 15879844
SHA1: 520afae357283c96610f340c92a6567ff7b2b923
SHA256: 9116bb2e313203bd78cd3e8dc09284d34b2645f725877623a7185bf3807c8ca3
SHA512: 1f8eb206a90121015b294dada7ea61ebd136e7e7dbb1c4bb7df21b85f359a2e733f438153bf07c57815a963e4ef3f766081fd4226caa6547f4c263b33ed7726e

https://cache.ruby-lang.org/pub/ruby/3.3/ruby-3.3.11.zip

文件大小: 26947458
SHA1: e01bf3ff08d96438decc35b80d4d289b9d012681
SHA256: 94c9d920aade547bafe392c6a288f996c151cb217ab548be5747867353568243
SHA512: fc4d4299df8414daeb81ae329d67f4d0ea961443e3505407a4faa134d8b9971c49b5c6750d55b4fdc210e15276845ee9b11c4ee25461f99a743f714da7096391

发布说明

许多提交者、开发人员以及用户提供了问题报告，帮助我们完成了此版本。感谢他们的贡献。

由 hsbt 发表于 2026-03-26
翻译： GAO Jun

Ruby 4.0.2 已发布

Mon, 16 Mar 2026 23:18:29 +0000

Ruby 4.0.2 已发布。

此版本是例行更新，修复了 YJIT 环境中 Puma 的 NoMethodError。详情可参考 GitHub 发布说明。

发布计划

我们计划每 2 个月为最新的 Ruby 稳定版本（目前是 Ruby 4.0）发布更新。 Ruby 4.0.3 将于五月发布，4.0.4 将于七月发布，4.0.5 将于九月发布，4.0.6 将于十一月发布。

如果存在会影响到大量用户的重大变更，我们也可能会提前发布新版本，后续版本的发布计划也将进行相应调整。

下载

https://cache.ruby-lang.org/pub/ruby/4.0/ruby-4.0.2.tar.gz

文件大小: 23824654
SHA1: 47c3627e2bdfe53dda77d3fa1730e44ef1ed7dfe
SHA256: 51502b26b50b68df4963336ca41e368cde92c928faf91654de4c4c1791f82aac
SHA512: 16a6ca0e9407051f58c8e3c4ec2058c52d62a9863174a3eb6dd5e9e2e893a66427e97a6e7fc8b4c3480163bd19a7a0ec4c00e481f90ff42e8f30bdbc9555f628

https://cache.ruby-lang.org/pub/ruby/4.0/ruby-4.0.2.tar.xz

文件大小: 17874724
SHA1: d927e26d22b15c6737df24cdf6ae80542a057240
SHA256: 4618db85bb9ec04d8152d0099db488694a3d3c4f52106625e4ad547f1318db87
SHA512: be71a5452068dfc3c86b8ec07456b3fdf6dc64e8c0cd16c358fc4ed8ac08707a9c28285ea8a79dbef82031d8c93c71032a82a0b45f3c9ac5325bf3b70d06fbf2

https://cache.ruby-lang.org/pub/ruby/4.0/ruby-4.0.2.zip

文件大小: 29123568
SHA1: 3cfd813761009f8fbb6001cf14149dc03bcd85d7
SHA256: 7cdbef9028a64f73ca59e21cd46c73c794df9c8294f1cb5c50c4d93c6060b240
SHA512: ecac80a6861fd666fc024701233f5b5b93bed9ed9047cd7ca9e11799681b0102729cc53203cee4ac33245a41b786a4a4c802633d1031881200378b011ed74580

发布说明

许多提交者、开发人员以及用户提供了问题报告，帮助我们完成了此版本。感谢他们的贡献。

由 k0kubun 发表于 2026-03-16
翻译： GAO Jun

Ruby 3.4.9 已发布

Wed, 11 Mar 2026 11:00:00 +0000

Ruby 3.4.9 已发布。

此版本包括了处理 CVE-2026-27820 的 zlib gem 更新，以及一些其他问题补丁。详情可参考 GitHub 发布说明。

我们建议您更新 zlib gem。由于包含了 zlib 的更新版本，对于希望继续将其作为默认 gem 的用户，此版本能让您不用再单独处理 zlib 更新。

下载

https://cache.ruby-lang.org/pub/ruby/3.4/ruby-3.4.9.tar.gz

文件大小: 22456968
SHA1: 6386200753caf4e336dafceeee165fa73fd234ec
SHA256: 7bb4d4f5e807cc27251d14d9d6086d182c5b25875191e44ab15b709cd7a7dd9c
SHA512: ac7147c0e575cf74f669abb991ee8695d4191c919f306f124b3ee85d6b61361e752a4f1afb7bdffb49aee21edace1fcc9bf2b074ada15fa6c1eb611354c1d54b

https://cache.ruby-lang.org/pub/ruby/3.4/ruby-3.4.9.tar.xz

文件大小: 16682004
SHA1: 1eb1b0b45b9e9191de9d2f360164e60eedf77012.
SHA256: 4231c54072601a171faed1699f105985e9971c94cd382b78feb4eb44eec2dd1a
SHA512: 356fb47cc56f2d25198cb95253fc20ff7d9a6fd1fa53bc475e5c440012aebe27562537c399d271357235114ade263fd625029b66cb0f9b526f9c04f169fb9580

https://cache.ruby-lang.org/pub/ruby/3.4/ruby-3.4.9.zip

文件大小: 27645906
SHA1: 8c4312fe946c7eaa269e5c7cee90f3b7350235b5
SHA256: a4dd555fddefcdd4a58d2169a568f5887b125edbbda2815ea826ca1833dc41ec
SHA512: 1c6cc4d03edb071f79f9ae41d43defa8393b467d30000e89ee872c6fe99bde015421cb1dd3ecfd5f0359c1c095b60833a95cd5f6c4397358f8ed98eace8720e2

发布说明

许多提交者、开发人员以及用户提供了问题报告，帮助我们完成了此版本。感谢他们的贡献。

由 nagachika 发表于 2026-03-11
翻译： GAO Jun

CVE-2026-27820: Zlib::GzipReader 中的缓存区溢出漏洞

Thu, 05 Mar 2026 00:00:00 +0000

Zlib::GzipReader 中存在一个缓存区溢出漏洞。此漏洞的 CVE 编号为 CVE-2026-27820。我们建议您更新 zlib gem。

详情

zstream_buffer_ungets 函数会在生成的输出前加上调用者提供的字节，但没有确保对应的 Ruby 字符串的长度是否足够。当缓冲区长度超过字符串容量时，将导致内存损坏。

建议操作

我们建议将 zlib gem 更新到 3.2.3 或后续版本。为了确保与较旧 Ruby 系列绑定版本的兼容性，您可以使用下面的方法进行更新：

Ruby 3.2：更新到 zlib 3.0.1
Ruby 3.3：更新到 zlib 3.1.2

您可以通过 gem update zlib 进行更新。如果您使用 bundler，请将 gem "zlib", ">= 3.2.3" 添加到 Gemfile 中。

受影响版本

zlib gem 3.2.2 或之前发布的版本

致谢

感谢 calysteon 汇报此问题。同时感谢 nobu 制作了补丁。

历史

最初发布于 2026-03-05 09:00:00 (UTC)

由 hsbt 发表于 2026-03-05
翻译： GAO Jun

Ruby 3.2.10 已发布

Wed, 14 Jan 2026 01:22:04 +0000

Ruby 3.2.10 已发布。

详细信息可参考 GitHub 发布说明。

下载

https://cache.ruby-lang.org/pub/ruby/3.2/ruby-3.2.10.tar.gz

文件大小: 19983731
SHA1: 6d7afca27627fbbcc7b933ac4e1a8a58c7a9be0e
SHA256: 880acb05e08da8c559c56a13e512bae1b472da67c72ebb750c765f9c2134e689
SHA512: 0f23dbc9b49b1c7c6256ba961c652a4f3659e6127a4c333624fca4e4f6a873cc06b01992b10aa7970a52e99b654fc655a25348a47de73cc786f3e33e8b702295

https://cache.ruby-lang.org/pub/ruby/3.2/ruby-3.2.10.tar.xz

文件大小: 14696548
SHA1: 2cc431a4c64c222b2f13574ec034226cd4fa2580
SHA256: a64a8a910ac2f28834b2170dedea688f06cbc6431fcd65eb18cc49ddbf3826ae
SHA512: a89044db8a55bd990d3756e212f2966b62b903eefc96c7e0af89aa4580ff7253d2f64c6c25fc04f2031b959e614bae84b86db36cfdec3a3e8afb5c3026426687

https://cache.ruby-lang.org/pub/ruby/3.2/ruby-3.2.10.zip

文件大小: 24593429
SHA1: e1123828b4b7a39c19342697d5e0af095237f0e3
SHA256: 8e98d793347a48cc7ef45cfdcb1bafa5151d114e8b8fc4dc094a9584af00049e
SHA512: b01077c71b9d006378620df95e3ffdb271fddc6f966a8cbbdb53f9f07e67b1924a1eadf200f5cc44ed87640c509b106c995386268d7dc10443a73ea39755aa44

发布说明

许多提交者、开发人员以及用户提供了问题报告，帮助我们完成了此版本。感谢他们的贡献。

由 hsbt 发表于 2026-01-14
翻译： GAO Jun

Ruby 4.0.1 已发布

Tue, 13 Jan 2026 02:28:48 +0000

Ruby 4.0.1 已发布。

此版本修复了当子进程在另一个线程中退出时，Kernel#sleep 函数会异常唤醒的问题，以及其他一些修正。详情可参考 GitHub 发布说明。

发布计划

我们计划每 2 个月发布最新的 Ruby 稳定版本（目前是 Ruby 4.0）。

Ruby 4.0.2 将于三月发布，4.0.3 将于五月发布，4.0.4 将于七月发布，4.0.5 将于九月发布，4.0.6 将于十一月发布。

如果存在会影响到大量用户的重大变更，我们也可能会提前发布新版本，后续版本的发布计划也将进行相应调整。

下载

https://cache.ruby-lang.org/pub/ruby/4.0/ruby-4.0.1.tar.gz

文件大小: 23807304
SHA1: 01db5746bbb29b028bd44d505a147d06866b1ab2
SHA256: 3924be2d05db30f4e35f859bf028be85f4b7dd01714142fd823e4af5de2faf9d
SHA512: f4eead09c7355b878a34343dd8cfb9c4c36f02ad3b9a7fd42981d722444beca0182ddea4fc771e2e01a05d9f14978a979ba0ba3590d366f53b6947f43fd78aff

https://cache.ruby-lang.org/pub/ruby/4.0/ruby-4.0.1.tar.xz

文件大小: 17892492
SHA1: 266e6fa80ed2b4f4bb7de2e98973dc084a1f380e
SHA256: 0531fe57dfdb56bf591620d2450642ea0e0964f3512a6ebee7dc9305de69395f
SHA512: b67d9d1f97ba30200d103f8454e39dc2d0450819d51d91eb5451d44b0bafc56d2fa48bb1be6c5081babe5828f679984bad02b9bcee7441f6bd34c0a95b8f200b

https://cache.ruby-lang.org/pub/ruby/4.0/ruby-4.0.1.zip

文件大小: 29107093
SHA1: d3a9217c848b22636025c525971578557ba5f7a3
SHA256: 36cbcea4972e201464ae1c6686a3a785b115aee9b836d9bbbe6d961dcef2358d
SHA512: a8512d3f57254bfacfd4c68ee50bb7cad3168f4d9c3be51658378e5db589032745759c360d8711a060b2ed5b9b78855e498b54fcba869a4e60f03ed4aae68ea8

发布说明

许多提交者、开发人员以及用户提供了问题报告，帮助我们完成了此版本。感谢他们的贡献。

由 k0kubun 发表于 2026-01-13
翻译： GAO Jun

Ruby 4.0.0 已发布

Thu, 25 Dec 2025 00:00:00 +0000

我们很高兴地宣布 Ruby 4.0.0 已发布。 Ruby 4.0 引入了 Ruby::Box 和 “ZJIT”，以及若干改进。

Ruby Box

Ruby Box 是一项新的（实验性）特性，提供了定义隔离的功能。可以通过设置环境变量 RUBY_BOX=1 来启用 Ruby Box。对应的类是 Ruby::Box。

在 Ruby Box 中载入的定义是隔离的。Ruby Box 之间可以互相隔离：猴子补丁、全局变量、类变量、类/模块定义、加载的原生库和 Ruby 库。

预期使用场景包括：

在 box 中运行带有猴子补丁的测试用例，避免影响其他测试用例
在应用服务器的 Ruby 进程中，并行运行 Web 应用 box，以此进行蓝绿部署
在 Web 应用的 box 中并行运行，在一段时间内，通过响应时间差异来评估依赖更新的效果
用作基础（底层）API，以实现某种“包”（高层）API（尚未设计）。

“Ruby Box” 的详细信息，可以参阅 Ruby::Box。 [Feature #21311] [Misc #21385]

ZJIT

ZJIT 是一个新的即时 (JIT) 编译器，它是作为 YJIT 的下一代产品进行开发的。您需要使用 Rust 1.85.0 或后续版本来构建 Ruby 才能使用，然后在运行时，指定 --zjit 来启用。

我们之所以创建这个新的 Ruby 编译器，是为了既能够提升性能上限（通过更大的变异单元和 SSA IR），又能够鼓励更多的外部贡献（通过成为更传统的方法编译器）。更多详情，可以参阅我们的博客。

ZJIT 目前比解释器更快，但还不如 YJIT。我们鼓励您尝试 ZJIT，但目前不建议将其用于生产环境。敬请期待 Ruby 4.1 的 ZJIT。

Ractor 实现

Ractor，即 Ruby 的并行执行机制，获得了多项改进。新类 Ractor::Port 被用来解决消息收发的相关问题（参见我们的博客）。另外，Ractor.shareable_proc 让 Ractor 之间共享 Proc 对象更加容易。

性能方面，改进了许多内部数据结构，大大减少了全局锁的争用，从而提升了并行性能。此外，Ractor 现在共享更少的内部数据，这也降低了并行运算时的 CPU 缓存争用。

Ractor 最初在 Ruby 3.0 作为实验性功能被引入。我们计划明年取消其 “实验性” 状态。

语言变化

*nil 不再调用 nil.to_a，就像 **nil 不再调用 nil.to_hash。 [Feature #21047]
行首的逻辑二元运算符 (||，&&，and 和 or) 与行首的 . 一样，延续上一行。下面两段代码是等价的：
```
  if condition1 && condition2
    ...
  end
```
```
  if condition1 &&
     condition2
    ...
  end
```
[Feature #20925]

核心类更新

注意：我们只列出了重要的核心类更新。

Array
- 新增 Array#rfind，提供了等价于 array.reverse_each.find 的高效方法 [Feature #21678]
- 新增 Array#find，提供了比 Enumerable#find 更高效的覆盖方法 [Feature #21678]
Binding
- Binding#local_variables 不再包含数字引用参数（如 _1, _2）。同样， Binding#local_variable_get 和 Binding#local_variable_set 也会拒绝处理数字引用参数。 [Bug #21049]
- 新增 Binding#implicit_parameters，Binding#implicit_parameter_get 和 Binding#implicit_parameter_defined?。用于访问数字引用参数和 it 参数。[Bug #21049]

Enumerator

Enumerator.produce 现在能够接受一个可选关键词参数 size 来指定枚举器的大小。这个参数可以是：整数，Float::INFINITY，可调用对象（如 lambda）或 nil（表示未知大小）。当此参数未指定时，默认使用 Float::INFINITY。

  # 无限枚举器
  enum = Enumerator.produce(1, size: Float::INFINITY, &:succ)
  enum.size  # => Float::INFINITY

  # 有限枚举器，指定了一个可计算的大小
  abs_dir = File.expand_path("./baz") # => "/foo/bar/baz"
  traverser = Enumerator.produce(abs_dir, size: -> { abs_dir.count("/") + 1 }) {
    raise StopIteration if it == "/"
    File.dirname(it)
  }
  traverser.size  # => 4

[Feature #21701]

错误高亮显示

当抛出了 ArgumentError，现在在展示代码段时，会同时显示调用方法代码段和方法定义代码段。 [Feature #21543]

test.rb:1:in 'Object#add': wrong number of arguments (given 1, expected 2) (ArgumentError)

    caller: test.rb:3
    | add(1)
      ^^^
    callee: test.rb:1
    | def add(x, y) = x + y
          ^^^
        from test.rb:3:in '<main>'

Fiber
- 引入和 Kernel#raise 类似的参数支持 Fiber#raise(cause:)。 [Feature #21360]
Fiber::Scheduler
- 引入 Fiber::Scheduler#fiber_interrupt，允许通过指定异常来终端纤程。典型的用例是当 IO 操作关闭时，中断等待此 IO 的纤程。 [Feature #21166]
- 引入 Fiber::Scheduler#yield，允许纤程调度器在禁用信号异常时继续处理。 [Bug #21633]
- 再次引入 Fiber::Scheduler#io_close 钩子来处理异步 IO#close.
- Fiber::Scheduler#io_write 在刷新 IO 写缓存时调用。 [Bug #21789]
File
- Linux 中，File::Stat#birthtime 在操作系统和文件系统支持的情况下，会通过 statx 系统调用实现。 [Feature #21205]
IO
- IO.select 允许使用 Float::INFINITY 作为超时参数。 [Feature #20610]
- 声明废弃行为：IO 类以传入 | 起始的字符串来创建进程的功能被移除。 [Feature #19630]

Kernel

Kernel#inspect 现在会检查是否存在 #instance_variables_to_inspect 方法，这个方法可以用来控制在 #inspect 的结果字符串中包含哪些实例变量：

  class DatabaseConfig
    def initialize(host, user, password)
      @host = host
      @user = user
      @password = password
    end

    private def instance_variables_to_inspect = [:@host, :@user]
  end

  conf = DatabaseConfig.new("localhost", "root", "hunter2")
  conf.inspect #=> #<DatabaseConfig:0x0000000104def350 @host="localhost", @user="root">

[Feature #21219]

声明废弃行为：Kernel#open 以传入 | 起始的字符串来创建进程的功能被移除。 [Feature #19630]

Math
- 新增 Math.log1p 和 Math.expm1。 [Feature #21527]
Pathname
- Pathname 从默认 gem 提升为 Ruby 核心类。 [Feature #17473]
Proc
- Proc#parameters 现在将匿名可选参数显示为 [:opt]，替代原来的 [:opt, nil]，使得输出能与需要匿名参数时一致。 [Bug #20974]
Ractor
- 新增 Ractor::Port 类，用于在 Ractor 之间进行通信的新同步机制。 [Feature #21262]
```
  port1 = Ractor::Port.new
  port2 = Ractor::Port.new
  Ractor.new port1, port2 do |port1, port2|
    port1 << 1
    port2 << 11
    port1 << 2
    port2 << 12
  end
  2.times{ p port1.receive } #=> 1, 2
  2.times{ p port2.receive } #=> 11, 12
```
  Ractor::Port 提供以下方法：
  - Ractor::Port#receive
  - Ractor::Port#send (或 Ractor::Port#<<)
  - Ractor::Port#close
  - Ractor::Port#closed?
  由此，Ractor.yield 和 Ractor#take 被移除。
- 新增 Ractor#join 和 Ractor#value，用于等待 Ractor 终止。这类似于 Thread#join 和 Thread#value。
- 新增 Ractor#monitor 和 Ractor#unmonitor 作为内部使用的底层接口来实现 Ractor#join。
- Ractor.select 现在只接受若干个 Ractor 和 Port 作为参数。如果参数是若干个 Ractor，方法会在最早结束的 Ractor 终止时返回。
- 新增 Ractor#default_port。每个 Ractor 都有一个默认端口，用于 Ractor.send，Ractor.receive。
- 移除 Ractor#close_incoming 和 Ractor#close_outgoing。
- 引入 Ractor.shareable_proc 和 Ractor.shareable_lambda 实现可共享的 Proc 或 lambda。 [Feature #21550], [Feature #21557]
Range
- Range#to_set 现在会先检查大小，来避免无上限 range 的问题。 [Bug #21654]
- Range#overlap? 现在可以正确处理无限（无界） range。 [Bug #21185]
- Range#max 在无下限整数 range 中的行为已修复。 [Bug #21174] [Bug #21175]
Ruby
- 定义了新的顶级模块 Ruby，包含了 Ruby 相关的常量，此模块在 Ruby 3.4 中被保留，现在被正式定义。 [Feature #20884]
Ruby::Box
- 这是一项新的（实验性）功能，用于实现定义分离。关于 “Ruby Box” 的详细信息，请参阅 doc/language/box.md。 [Feature #21311] [Misc #21385]
Set
- Set 现在是一个核心类，不再是自动加载的标准库类。 [Feature #21216]
- Set#inspect 现在返回一个更适合 eval 的字符串，使用 Set[] 语法（如： Set[1, 2, 3]，代替原来的 #<Set: {1, 2, 3}>）。 [Feature #21389]
- 声明废弃向方法 Set#to_set 和 Enumerable#to_set 传递参数的行为。 [Feature #21390]
Socket
- Socket.tcp 和 TCPSocket.new 现在能接受关键词参数 open_timeout 来定义初始连接时的超时时间。 [Feature #21347]
- 如果用户在 TCPSocket.new 中指定了超时时间，根据具体情况，Errno::ETIMEDOUT 或 IO::TimeoutError 都可能被更早抛出。此行为目前被统一为抛出 IO::TimeoutError。（请注意，在 Socket.tcp 中，仍然可能有某些情况下会抛出 Errno::ETIMEDOUT，同样如果是操作系统层级发生超时，也可能抛出 Errno::ETIMEDOUT）
String
- 更新 Unicode 版本至 17.0.0，更新 Emoji 版本至 17.0。 [Feature #19908][Feature #20724][Feature #21275] （同样适用于 Regexp）
- 扩展 String#strip，strip!，lstrip，lstrip!，rstrip 和 rstrip! 以接受 *selectors 参数。 [Feature #21552]
Thread
- 引入和 Kernel#raise 类似的参数支持 Thread#raise(cause:)。 [Feature #21360]

标准库更新

我们只列出了重要的标准库更新。

其他变更列在下方。如果 gem 有自己的 GitHub 发布页面，我们还列出了自 Ruby 3.4.0 以来的发布历史。

以下默认 gems 提升为绑定 gem。

ostruct 0.6.3
- 0.6.1 至 v0.6.2, v0.6.3
pstore 0.2.0
- 0.1.4 至 v0.2.0
benchmark 0.5.0
- 0.4.0 至 v0.4.1, v0.5.0
logger 1.7.0
- 1.6.4 至 v1.6.5, v1.6.6, v1.7.0
rdoc 7.0.2
- 6.14.0 至 v6.14.1, v6.14.2, v6.15.0, v6.15.1, v6.16.0, v6.16.1, v6.17.0, v7.0.0, v7.0.1, v7.0.2, v7.0.3
win32ole 1.9.2
- 1.9.1 至 v1.9.2
irb 1.16.0
- 1.14.3 至 v1.15.0, v1.15.1, v1.15.2, v1.15.3, v1.16.0
reline 0.6.3
- 0.6.0 至 v0.6.1, v0.6.2, v0.6.3
readline 0.0.4
fiddle 1.1.8
- 1.1.6 至 v1.1.7, v1.1.8

新增以下默认 gem。

win32-registry 0.1.2

更新以下默认 gem。

RubyGems 4.0.3
bundler 4.0.3
date 3.5.1
- 3.4.1 至 v3.5.0, v3.5.1
delegate 0.6.1
- 0.4.0 至 v0.5.0, v0.6.0, v0.6.1
digest 3.2.1
- 3.2.0 至 v3.2.1
english 0.8.1
- 0.8.0 至 v0.8.1
erb 6.0.1
- 4.0.4 至 v5.1.2, v5.1.3, v6.0.0, v6.0.1
error_highlight 0.7.1
etc 1.4.6
fcntl 1.3.0
- 1.2.0 至 v1.3.0
fileutils 1.8.0
- 1.7.3 至 v1.8.0
forwardable 1.4.0
- 1.3.3 至 v1.4.0
io-console 0.8.2
- 0.8.1 至 v0.8.2
io-nonblock 0.3.2
io-wait 0.4.0
- 0.3.2 至 v0.3.3, v0.3.5.test1, v0.3.5, v0.3.6, v0.4.0
ipaddr 1.2.8
json 2.18.0
- 2.9.1 至 v2.10.0, v2.10.1, v2.10.2, v2.11.0, v2.11.1, v2.11.2, v2.11.3, v2.12.0, v2.12.1, v2.12.2, v2.13.0, v2.13.1, v2.13.2, v2.14.0, v2.14.1, v2.15.0, v2.15.1, v2.15.2, v2.16.0, v2.17.0, v2.17.1, v2.18.0
net-http 0.9.1
- 0.6.0 至 v0.7.0, v0.8.0, v0.9.0, v0.9.1
openssl 4.0.0
- 3.3.1 至 v3.3.2, v4.0.0
optparse 0.8.1
- 0.6.0 至 v0.7.0, v0.8.0, v0.8.1
pp 0.6.3
- 0.6.2 至 v0.6.3
prism 1.7.0
- 1.5.2 至 v1.6.0, v1.7.0
psych 5.3.1
- 5.2.2 至 v5.2.3, v5.2.4, v5.2.5, v5.2.6, v5.3.0, v5.3.1
resolv 0.7.0
- 0.6.2 至 v0.6.3, v0.7.0
stringio 3.2.0
- 3.1.2 至 v3.1.3, v3.1.4, v3.1.5, v3.1.6, v3.1.7, v3.1.8, v3.1.9, v3.2.0
strscan 3.1.6
- 3.1.2 至 v3.1.3, v3.1.4, v3.1.5, v3.1.6
time 0.4.2
- 0.4.1 至 v0.4.2
timeout 0.6.0
- 0.4.3 至 v0.4.4, v0.5.0, v0.6.0
uri 1.1.1
- 1.0.4 至 v1.1.0, v1.1.1
weakref 0.1.4
- 0.1.3 至 v0.1.4
zlib 3.2.2
- 3.2.1 至 v3.2.2

更新以下绑定 gem。

minitest 6.0.0
power_assert 3.0.1
- 2.0.5 至 v3.0.0, v3.0.1
rake 13.3.1
- 13.2.1 至 v13.3.0, v13.3.1
test-unit 3.7.3
- 3.6.7 至 3.6.8, 3.6.9, 3.7.0, 3.7.1, 3.7.2, 3.7.3, 3.7.4, 3.7.5
rexml 3.4.4
rss 0.3.2
- 0.3.1 至 0.3.2
net-ftp 0.3.9
- 0.3.8 至 v0.3.9
net-imap 0.6.2
- 0.5.8 至 v0.5.9, v0.5.10, v0.5.11, v0.5.12, v0.5.13, v0.6.0, v0.6.1, v0.6.2
net-smtp 0.5.1
- 0.5.0 至 v0.5.1
matrix 0.4.3
- 0.4.2 至 v0.4.3
prime 0.1.4
- 0.1.3 至 v0.1.4
rbs 3.10.0
- 3.8.0 至 v3.8.1, v3.9.0.dev.1, v3.9.0.pre.1, v3.9.0.pre.2, v3.9.0, v3.9.1, v3.9.2, v3.9.3, v3.9.4, v3.9.5, v3.10.0.pre.1, v3.10.0.pre.2, v3.10.0
typeprof 0.31.1
debug 1.11.1
- 1.11.0 至 v1.11.1
base64 0.3.0
- 0.2.0 至 v0.3.0
bigdecimal 4.0.1
- 3.1.8 至 v3.2.0, v3.2.1, v3.2.2, v3.2.3, v3.3.0, v3.3.1, v4.0.0, v4.0.1
drb 2.2.3
- 2.2.1 至 v2.2.3
syslog 0.3.0
- 0.2.0 至 v0.3.0
csv 3.3.5
- 3.3.2 至 v3.3.3, v3.3.4, v3.3.5
repl_type_completor 0.1.12

RubyGems 和 Bundler

Ruby 4.0 绑定了 RubyGems 和 Bundler 版本 4。您可以通过下面的链接查看详情。

支持平台

Windows
- 不再支持 14.0（_MSC_VER 1900）之前的 MSVC 版本。这意味着现在需要 Visual Studio 2015 或更高版本。

兼容性问题

由于新增了 Ractor::Port，以下方法从 Ractor 中被移除：
- Ractor.yield
- Ractor#take
- Ractor#close_incoming
- Ractor#close_outgoging
[Feature #21262]
声明废弃 ObjectSpace._id2ref。 [Feature #15408]
移除 Process::Status#& 和 Process::Status#>>，他们已在 Ruby 3.3 中声明废弃。 [Bug #19868]
移除 rb_path_check。此方法原用来检查已在 Ruby 2.7 中移除的 $SAFE 路径。 [Feature #20971]
ArgumentError 中，”wrong number of arguments” 现在会包含被调用方法的类或模块名。（如：Foo#bar 替代原来的 bar）。 [Bug #21698]

错误栈现在不再展示 internal 帧。这些方法现在看起来像是在 Ruby 源文件中，与其他 C 语言实现的方法保持一致。 [Bug #20968]

此前：

ruby -e '[1].fetch_values(42)'
<internal:array>:211:in 'Array#fetch': index 42 outside of array bounds: -1...1 (IndexError)
        from <internal:array>:211:in 'block in Array#fetch_values'
        from <internal:array>:211:in 'Array#map!'
        from <internal:array>:211:in 'Array#fetch_values'
        from -e:1:in '<main>'

现在：

$ ruby -e '[1].fetch_values(42)'
-e:1:in 'Array#fetch_values': index 42 outside of array bounds: -1...1 (IndexError)
        from -e:1:in '<main>'

标准库兼容性问题

CGI 库从默认 gems 中移除。现在 cgi/escape 仅提供下列方法：
- CGI.escape 和 CGI.unescape
- CGI.escapeHTML 和 CGI.unescapeHTML
- CGI.escapeURIComponent 和 CGI.unescapeURIComponent
- CGI.escapeElement 和 CGI.unescapeElement
[Feature #21258]
随着 Set 类从标准库升为核型类，set/sorted_set.rb 被移除。 SortedSet 不再是自动加载的常量。如需使用 SortedSet，请先安装 sorted_set gem，然后执行 require 'sorted_set'。 [Feature #21287]
Net::HTTP
- 此前，在发送带有 body 的请求（如：POST，PUT）时，如果没有明确制定，那么 HTTP 头 Content-Type 会被自动设置为 application/x-www-form-urlencoded。此行为现在被移除。如果您的应用依赖这个默认行为，那么您的请求现在将缺失 Content-Type 头，这可能导致在与特定服务器交互时出现兼容性错误。 [GH-net-http #205]

C API 更新

IO
- rb_thread_fd_close 已声明废弃，如果执行将不产生任何效果。如果您需要将 C 扩展的文件描述符暴露给 Ruby 代码，可以创建一个使用 RUBY_IO_MODE_EXTERNAL 的 IO 实例，然后使用 rb_io_close(io) 进行关闭（此操作也会中断并等待该 IO 上所有的待处理操作)。直接关闭文件描述符不会中断待处理操作，可能会导致未定义的行为。换言之，如果两个 IO 对象共享相同的文件描述符，则关闭一个不会影响另一个。 [Feature #18455]
GVL
- 现在，无论是否使用 GVL，rb_thread_call_with_gvl 都可以正常工作。这使得 gem 可以避免检查 ruby_thread_has_gvl_p。但仍请谨慎对待 GVL。 [Feature #20750]
Set
- 新增一组用于 Set 的 C API。支持以下方法： [Feature #21459]
  - rb_set_foreach
  - rb_set_new
  - rb_set_new_capa
  - rb_set_lookup
  - rb_set_add
  - rb_set_clear
  - rb_set_delete
  - rb_set_size

实现改进

Class#new（如：Object.new）在所有情况下都更快，尤其是在传递关键字参数时。此功能同时被集成到 YJIT 和 ZJIT 中。[Feature #21254]
不同大小的 GC 堆现在独立增长。当只有某些池包含长期活跃对象时，将减少内存使用量。
GC 清除包含大对象的页面的速度更快。
“泛型 ivar” 对象（String，Array，TypedData等）现在使用新内部 “fields” 对象来加速实例变量的访问。
在初次使用前，GC 会避免维护内部的 id2ref 表，提升 object_id 的分配和 GC 清除速度。
类和模块对象的 object_id 和 hash 方法更快。
较大的大整数可以通过可变宽度分配保持嵌入状态。
Random，Enumerator::Product，Enumerator::Chain，Addrinfo，StringScanner 以及一些内部对象现在处于写屏障保护中，从而减少 GC 开销。

Ractor

为了让 Ractor 更加稳定、高效、易用，我们投入了大量的工作。这些改进让 Ractor 的实现逐渐完整，并即将离开实验性状态。

性能提升
- 冻结字符串和符号表在内部使用了无锁哈希集合 [Feature #21268]
- 方法缓存查找在多数场景下可以避免锁定
- 类（以及一般实例变量）实例变量访问速度更快，并且可以避免锁定
- 通过为每个 ractor 使用计数器，降低对象内存分配时的 CPU 缓存争用
- 通过使用线程本地计数器，减少 xmallloc/xfree 中的 CPU 缓存争用
- 在多数场景下 object_id 能避免锁定
错误修复和稳定性提升
- 修正了同时使用 Ractors 和进程时的可能死锁情况
- 修正了 Ractor 中 require 和自动载入的问题
- 修正了 Ractors 间的编码/转码问题
- 修复了 GC 操作和方法失效中的竞争条件
- 修正了在启动 Ractor 后进行进程分叉的问题
- Ractor 中的 GC 分配计数现在是准确的
- 修正了 GC 后，TracePoints 不能正常工作的问题 [Bug #19112]

JIT

ZJIT
- 引入了实验性的基于方法的 JIT 编译器. ZJIT 可以通过两种方法启用：使用 --zjit 参数，或者调用 RubyVM::ZJIT.enable。构建 Ruby 时，如要包含 ZJIT 支持，需要使用 Rust 1.85.0 或后续版本来构建。
- 从 Ruby 4.0.0 起，ZJIT 比解释器更快，但还不及 YJIT。我们鼓励尝试 ZJIT，但目前不建议将其用于生产环境。
- 我们的目标是让 ZJIT 比 YJIT 更快，并在 Ruby 4.1 时可用于生产环境。
YJIT
- RubyVM::YJIT.runtime_stats
  - ratio_in_yjit 在标准构建中不可用。可以在 configure 中设置 --enable-yjit=stats 并在调用时通过 --yjit-stats 来启用。
  - 在默认统计中新增 invalidate_everything，当 TracePoint 失效代码时，此统计信息会递增。
- RubyVM::YJIT.enable 新增选项 mem_size: 和 call_threshold:。
RJIT
- 移除 --rjit。我们将把第三方 JIT API 实现迁移到 ruby/rjit 代码库。

更多详情，可参见新闻或提交日志。

自 Ruby 3.4.0 以来，这些变化共导致 3889 个文件被更改，新增 230769 行(+)，删除 297003 行(-)！

圣诞快乐，新年快乐，一起来享受 Ruby 4.0 的编程乐趣！

下载

https://cache.ruby-lang.org/pub/ruby/4.0/ruby-4.0.0.tar.gz

文件大小: 23955109
SHA1: 754e39e9ad122e1b6deaed860350bac133a35ed3
SHA256: 2e8389c8c072cb658c93a1372732d9eac84082c88b065750db1e52a5ac630271
SHA512: 688254e939b197d564e896fb951bc1abf07142f489e91c5ed0b11f68f52d6adb6b1f86616fe03f1f0bb434beeef7e75e158b9c616afb39bb34403b0b78d2ee19

https://cache.ruby-lang.org/pub/ruby/4.0/ruby-4.0.0.tar.xz

文件大小: 18008368
SHA1: 05ec670e86f84325c5353ef2f2888e53b6adc602
SHA256: a72bacee9de07283ebc19baa4ac243b193129f21aa4e168c7186fb1fe7d07fe1
SHA512: 2d5b2e566eaf70a5f3ea6ce6afc0611c0415de58a41336ef7a0b855c9a91eda9aa790a5f8b48e40a1eb9d50f8ea0f687216e617f16c8d040a08474f3116518a4

https://cache.ruby-lang.org/pub/ruby/4.0/ruby-4.0.0.zip

文件大小: 29253204
SHA1: 0b69f89d1d140157251c0d3a6032f6c45cdf81e8
SHA256: 70cb1bf89279b86ab9a975d504607c051fc05ee03e311d550a5541b65e373455
SHA512: a72e076ef618c0aeb9d20cf22e6fb12fda36809c0064ef0f98153b95a0bac257ef606342444a38f992c4594bf376a4d264686cf597463aa6f111220798784302

Ruby 是什么

Ruby 最初由 Matz （松本行弘，Yukihiro Matsumoto）于 1993 年开发，现在以开源软件的形式开发。它可以在多个平台上运行，并在全球得到广泛使用，尤其是 Web 开发领域。

由 naruse 发表于 2025-12-25
翻译： GAO Jun

全新的 Ruby 文档界面

Tue, 23 Dec 2025 00:00:00 +0000

继重新设计 ruby-lang.org之后，我们还有更多消息来庆祝 Ruby 诞生 30 周年：docs.ruby-lang.org 采用了全新的、RDoc 的 Aliki 默认主题。

全新的 Ruby 文档界面

一直以来，编写 Ruby 程序让人愉悦，现在阅读 Ruby 文档也能带来相似的感受。Aliki 为 docs.ruby-lang.org 及所有通过 RDoc v7.0+ 生成文档的 gem 带来了现代、简介的文档界面。

主要特点

改进搜索功能: 根据大小写匹配设置权重，模糊匹配，支持常量搜索
深色模式: 遵从操作系统的偏好设置，也可手动切换
三栏布局: 左侧栏用于导航，中间栏显示内容，右侧栏显示目录
代码块改进: 在代码块上增加复制按钮，支持 C 语言语法高亮
自定义脚注: Gem 维护者可以增加指向代码库、问题跟踪和其他资源的链接

致 Gem 作者

如果您使用 RDoc 7.0+ 来生成文档，您的用户就会看到 Aliki 主题。您可以通过 .rdoc_options 文件来定制脚注链接或切换回 Darkfish 主题。

快试试

访问 docs.ruby-lang.org 查看新界面的实际效果。

如果您发现问题或有任何建议，请在 Github 上提交问题报告。

由 Stan Lo 发表于 2025-12-23
翻译： GAO Jun

重新设计我们的网站标识

Mon, 22 Dec 2025 05:46:09 +0000

我们激动地宣布网站已经全面改版。此次更新的设计方案由 Taeko Akatsuka (赤塚妙子) 创作。

作为更新的一部分，我们重新设计了网站标识：”A language where people gather, a site where people are visible.”

30年来，Ruby 语言一直关注“程序员的幸福感”。新的主视觉形象表达了人们围绕在 Ruby 周围的景象。

该作品以 Ruby logo 为中心，向外辐射出各种手绘人物，代表着世界各地的开发者通过 Ruby 连接起来，在各自的领域创造价值，同时与熟悉的元素相伴，享受 Ruby 带来的乐趣。

在展现 Ruby 的生态、生产力和社区优势的同时，温暖的视觉风格也体现了 Ruby 自诞生以来始终如一的乐趣、亲和力和可触感。我们致力于打造一种其他编程语言网站所不具备的、 Ruby 独有的表达方式。

Matz (松本行弘) 强调，除了生态、生产力和社区之外，简洁也是 Ruby 的优势之一。在新设计中，紧随主视觉图之后，展示了 Ruby 代码，以强调其作为编程语言的本质。

我们还加入了对社区成员的访谈和照片，让您能感受到编程语言背后的众多贡献者。

基于全新设计的网站整体更新仍在进行中，目前仍有许多待完善之处，例如失效链接和内容不一致等问题。我们竭诚欢迎您的反馈。

由 Hiroshi SHIBATA 发表于 2025-12-22
翻译： GAO Jun