Ruby 3.2.0 的 NEWS¶ ↑

本文档列出了自 3.1.0 版本以来用户可见的功能变更，不包括错误修复。

请注意，每个条目都保持最小化，详细信息请参阅链接。

语言变更¶ ↑

匿名剩余参数和关键字剩余参数现在可以作为参数传递，而不仅仅是在方法参数中使用。[Feature #18351]
```
def foo(*)
  bar(*)
end
def baz(**)
  quux(**)
end
```

接受单个位置参数和关键字的 proc 将不再自动展开。[Bug #18633]

proc{|a, **k| a}.call([1, 2])
# Ruby 3.1 and before
# => 1
# Ruby 3.2 and after
# => [1, 2]

在显式对象上设置常量的常量赋值求值顺序已与单属性赋值求值顺序保持一致。对于这段代码
```
foo::BAR = baz
```
foo 现在在 baz 之前被调用。类似地，对于对常量的多次赋值，使用从左到右的求值顺序。对于这段代码
```
foo1::BAR1, foo2::BAR2 = baz1, baz2
```
现在使用以下求值顺序
1. foo1
2. foo2
3. baz1
4. baz2
[Bug #15928]
“查找模式” 不再是实验性的。[Feature #18585]
接受剩余参数（如 *args）并希望通过 foo(*args) 委托关键字参数的方法现在必须用 ruby2_keywords 标记（如果尚未标记）。换句话说，所有希望通过 *args 委托关键字参数的方法现在都必须用 ruby2_keywords 标记，没有例外。这将更容易过渡到其他委托方式，一旦库可以要求 Ruby 3+。以前，如果接收方法接受 *args，则保留 ruby2_keywords 标志，但这是一个错误和不一致。查找潜在缺失的 ruby2_keywords 的一个好方法是运行测试套件，对于失败的地方，找到必须接收关键字参数的最后一个方法，在那里使用 puts nil, caller, nil，并检查调用链中每个必须委托关键字的方法/块是否正确标记为 ruby2_keywords。[Bug #18625] [Bug #16466]
```
def target(**kw)
end

# Accidentally worked without ruby2_keywords in Ruby 2.7-3.1, ruby2_keywords
# needed in 3.2+. Just like (*args, **kwargs) or (...) would be needed on
# both #foo and #bar when migrating away from ruby2_keywords.
ruby2_keywords def bar(*args)
  target(*args)
end

ruby2_keywords def foo(*args)
  bar(*args)
end

foo(k: 1)
```

核心类更新¶ ↑

注意：我们只列出突出的类更新。

Fiber
- 引入 Fiber.[] 和 Fiber.[]= 用于可继承的 fiber 存储。引入 Fiber#storage 和 Fiber#storage=（实验性）用于获取和重置当前存储。引入 Fiber.new(storage:) 用于在创建 fiber 时设置存储。[Feature #19078]
  
  现有的 Thread 和 Fiber 局部变量可能很难使用。线程局部变量在所有 fiber 之间共享，使得隔离很困难，而 Fiber 局部变量可能很难共享。通常希望定义执行单元（“执行上下文”），以便在该上下文中创建的所有 fiber 和线程之间共享某些状态。这就是 Fiber 存储提供的功能。
```
def log(message)
  puts "#{Fiber[:request_id]}: #{message}"
end

def handle_requests
  while request = read_request
    Fiber.schedule do
      Fiber[:request_id] = SecureRandom.uuid

      request.messages.each do |message|
        Fiber.schedule do
          log("Handling #{message}") # Log includes inherited request_id.
        end
      end
    end
  end
end
```
  通常，对于任何希望在给定上下文中创建的所有 fiber 和线程之间隐式共享的状态，您应该考虑使用 Fiber 存储，例如连接池、请求 ID、日志记录器级别、环境变量、配置等。
Fiber::Scheduler
- 引入 Fiber::Scheduler#io_select 用于非阻塞 IO.select。[Feature #19060]
IO
- 引入 IO#timeout= 和 IO#timeout，如果阻塞操作超过指定的超时时间，可能会引发 IO::TimeoutError。[Feature #18630]
```
STDIN.timeout = 1
STDIN.read # => Blocking operation timed out! (IO::TimeoutError)
```
- 引入 IO.new(..., path:) 并将 File#path 提升为 IO#path。[Feature #19036]

Class

Class#attached_object，返回接收者为其单例类的对象。如果接收者不是单例类，则引发 TypeError。[Feature #12084]

class Foo; end

Foo.singleton_class.attached_object        #=> Foo
Foo.new.singleton_class.attached_object    #=> #<Foo:0x000000010491a370>
Foo.attached_object                        #=> TypeError: `Foo' is not a singleton class
nil.singleton_class.attached_object        #=> TypeError: `NilClass' is not a singleton class

Data

新的核心类，用于表示简单的不可变值对象。该类类似于 Struct 并且部分共享实现，但具有更精简和严格的 API。[Feature #16122]

Measure = Data.define(:amount, :unit)
distance = Measure.new(100, 'km')            #=> #<data Measure amount=100, unit="km">
weight = Measure.new(amount: 50, unit: 'kg') #=> #<data Measure amount=50, unit="kg">
weight.with(amount: 40)                      #=> #<data Measure amount=40, unit="kg">
weight.amount                                #=> 50
weight.amount = 40                           #=> NoMethodError: undefined method `amount='

Encoding
- Encoding#replicate 已被弃用，将在 3.3 中删除。[Feature #18949]
- 虚拟 Encoding::UTF_16 和 Encoding::UTF_32 编码不再尝试根据字节顺序标记动态猜测字节序。请改用 Encoding::UTF_16BE/UTF_16LE 和 Encoding::UTF_32BE/UTF_32LE。此更改加快了获取 String 的编码的速度。[Feature #18949]
- 将最大编码集大小限制为 256。如果超过最大大小，将引发 EncodingError。[Feature #18949]
Enumerator
- 添加了 Enumerator.product。 Enumerator::Product 是其实现。[Feature #18685]
Exception
- 添加了 Exception#detailed_message。默认的错误打印器在 Exception 对象上调用此方法，而不是消息。[Feature #18564]
Hash
- 如果哈希为空，Hash#shift 现在始终返回 nil，而不是返回默认值或调用默认 proc。[Bug #16908]
Integer
- 添加了 Integer#ceildiv。[Feature #18809]
Kernel
- 如果从非 Ruby 帧（例如在 C 中定义的方法）调用，Kernel#binding 会引发 RuntimeError。[Bug #18487]
MatchData
- 添加了 MatchData#byteoffset。[Feature #13110]
- 添加了 MatchData#deconstruct。[Feature #18821]
- 添加了 MatchData#deconstruct_keys。[Feature #18821]
Module
- 添加了 Module.used_refinements。[Feature #14332]
- 添加了 Module#refinements。[Feature #12737]
- 添加了 Module#const_added。[Feature #17881]
- 添加了 Module#undefined_instance_methods。[Feature #12655]
Proc
- Proc#dup 返回子类的实例。[Bug #17545]
- Proc#parameters 现在接受 lambda 关键字。[Feature #15357]
Process
- 为 FreeBSD 平台添加了 RLIMIT_NPTS 常量
Regexp
- 引入了基于缓存的优化。现在，许多（但不是全部）Regexp匹配都可以在线性时间内完成，这将防止正则表达式拒绝服务 (ReDoS) 漏洞。[Feature #19104]
- 引入了 Regexp.linear_time?。[Feature #19194]
- Regexp.new 现在支持将正则表达式标志作为 String 而不仅仅是 Integer 传递。未知的标志会引发 ArgumentError。否则，除了 true、false、nil 或 Integer 之外的任何内容都将发出警告。[Feature #18788]
- 增加了 Regexp.timeout=。此外，Regexp.new 新增了 timeout 关键字的支持。请参见 [Feature #17837]
Refinement
- 增加了 Refinement#refined_class。[Feature #12737]

RubyVM::AbstractSyntaxTree

为 parse、parse_file 和 of 添加了 error_tolerant 选项。[Feature #19013] 使用此选项

SyntaxError 将被抑制
对于无效的输入，将返回 AST
当解析器到达输入末尾但 end 不足时，将补充 end
end 根据缩进被视为关键字

# Without error_tolerant option
root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY)
def m
  a = 10
  if
end
RUBY
# => <internal:ast>:33:in `parse': syntax error, unexpected `end' (SyntaxError)

# With error_tolerant option
root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY, error_tolerant: true)
def m
  a = 10
  if
end
RUBY
p root # => #<RubyVM::AbstractSyntaxTree::Node:SCOPE@1:0-4:3>

# `end` is treated as keyword based on indent
root = RubyVM::AbstractSyntaxTree.parse(<<~RUBY, error_tolerant: true)
module Z
  class Foo
    foo.
  end

  def bar
  end
end
RUBY
p root.children[-1].children[-1].children[-1].children[-2..-1]
# => [#<RubyVM::AbstractSyntaxTree::Node:CLASS@2:2-4:5>, #<RubyVM::AbstractSyntaxTree::Node:DEFN@6:2-7:5>]

为 parse、parse_file 和 of 添加了 keep_tokens 选项。为 RubyVM::AbstractSyntaxTree::Node 添加了 tokens 和 all_tokens。[Feature #19070]

root = RubyVM::AbstractSyntaxTree.parse("x = 1 + 2", keep_tokens: true)
root.tokens # => [[0, :tIDENTIFIER, "x", [1, 0, 1, 1]], [1, :tSP, " ", [1, 1, 1, 2]], ...]
root.tokens.map{_1[2]}.join # => "x = 1 + 2"

Set
- 现在，Set 作为内置类提供，无需 require "set"。[Feature #16989] 它目前通过 Set 常量或调用 Enumerable#to_set 进行自动加载。
String
- 增加了 String#byteindex 和 String#byterindex。[Feature #13110]
- 将 Unicode 更新到 15.0.0 版本，Emoji 更新到 15.0 版本。[Feature #18639]（也适用于 Regexp）
- 增加了 String#bytesplice。[Feature #18598]
- 增加了 String#dedup 作为 String#-@ 的别名。[Feature #18595]

Struct

现在，Struct 类也可以使用关键字参数初始化，而无需在 Struct.new 上使用 keyword_init: true。[Feature #16806]

Post = Struct.new(:id, :name)
Post.new(1, "hello") #=> #<struct Post id=1, name="hello">
# From Ruby 3.2, the following code also works without keyword_init: true.
Post.new(id: 1, name: "hello") #=> #<struct Post id=1, name="hello">

Thread
- 增加了 Thread.each_caller_location。[Feature #16663]
Thread::Queue
- 增加了 Thread::Queue#pop(timeout: sec)。[Feature #18774]
Thread::SizedQueue
- 增加了 Thread::SizedQueue#pop(timeout: sec)。[Feature #18774]
- 增加了 Thread::SizedQueue#push(timeout: sec)。[Feature #18944]
Time
- 增加了 Time#deconstruct_keys，允许在模式匹配表达式中使用 Time 实例。[Feature #19071]
- 现在，Time.new 可以解析类似于 Time#inspect 生成的字符串，并根据给定的参数返回一个 Time 实例。[Feature #18033]
SyntaxError
- 增加了 SyntaxError#path。[Feature #19138]
TracePoint
- 现在，对于 c_call/c_return TracePoints，TracePoint#binding 返回 nil。[Bug #18487]
- 如果给定了块，并且没有传递 target 和 target_line 关键字参数，则 TracePoint#enable 的 target_thread 关键字参数现在默认为当前线程。[Bug #16889]
UnboundMethod
- 如果实际方法相同，UnboundMethod#== 返回 true。例如，String.instance_method(:object_id) == Array.instance_method(:object_id) 返回 true。[Feature #18798]
- UnboundMethod#inspect 不再显示 instance_method 的接收者。例如，String.instance_method(:object_id).inspect 返回 "#<UnboundMethod: Kernel#object_id()>"（之前是 "#<UnboundMethod: String(Kernel)#object_id()>"）。
GC
- 通过 GC.latest_gc_info 公开 need_major_gc。GH-6791
ObjectSpace
- ObjectSpace.dump_all 也转储 shapes。GH-6868

Stdlib 更新¶ ↑

Bundler
- 现在，Bundler 使用 PubGrub 解析器，而不是 Molinillo，以提高性能。
- 为 bundle gem 添加 --ext=rust 支持，以创建带有 Rust 扩展的简单 gem。[GH-rubygems-6149]
- 使克隆 git 存储库的速度更快 [GH-rubygems-4475]
RubyGems
- 为 cargo 构建器添加 mswin 支持。[GH-rubygems-6167]
CGI
- 增加了 CGI.escapeURIComponent 和 CGI.unescapeURIComponent。[Feature #18822]
Coverage
- 现在，Coverage.setup 接受 eval: true。通过此选项，eval 和相关方法能够生成代码覆盖率。[Feature #19008]
- Coverage.supported?(mode) 允许检测支持哪些覆盖率模式。[Feature #19026]
Date
- 添加了 Date#deconstruct_keys 和 DateTime#deconstruct_keys，与 [Feature #19071] 相同
ERB
- ERB::Util.html_escape 比 CGI.escapeHTML 更快。
  - 当没有字符需要转义时，它不再分配 String 对象。
  - 当参数已经是 String 时，它会跳过调用 to_s 方法。
  - 添加了 ERB::Escape.html_escape 作为 ERB::Util.html_escape 的别名，它没有被 Rails monkey-patch。
- 使用 CGI.escapeURIComponent 使 ERB::Util.url_encode 更快。
- 从 erb 命令中删除了 -S 选项。
FileUtils
- 为 FileUtils.ln_s 添加了 FileUtils.ln_sr 方法和 relative: 选项。[Feature #18925]
IRB
- 添加了 debug.gem 集成命令：debug、break、catch、next、delete、step、continue、finish、backtrace、info
  - 即使你的 Gemfile 中没有 gem "debug"，它们也可以工作。
  - 另请参阅：Ruby 3.2 的 IRB 中有哪些新功能？
- 添加了更多类似 Pry 的命令和功能。
  - 添加了 edit 和 show_cmds（如 Pry 的 help）。
  - ls 接受 -g 或 -G 选项来过滤输出。
  - show_source 是 $ 的别名，并接受未加引号的输入。
  - whereami 是 @ 的别名。
Net::Protocol
- 改进了 Net::BufferedIO 的性能。[GH-net-protocol-14]
Pathname
- 添加了 Pathname#lutime。[GH-pathname-20]
Socket
- 为支持的平台添加了以下常量。
  - SO_INCOMING_CPU
  - SO_INCOMING_NAPI_ID
  - SO_RTABLE
  - SO_SETFIB
  - SO_USER_COOKIE
  - TCP_KEEPALIVE
  - TCP_CONNECTION_INFO
SyntaxSuggest
- 以前的 dead_end 的 syntax_suggest 功能已集成到 Ruby 中。[Feature #18159]
UNIXSocket
- 添加了对 Windows 上 UNIXSocket 的支持。模拟匿名套接字。添加了对 File.socket? 和 File::Stat#socket? 的支持（如果可能）。[Feature #19135]
更新了以下默认 gem。
- RubyGems 3.4.1
- abbrev 0.1.1
- benchmark 0.2.1
- bigdecimal 3.1.3
- bundler 2.4.1
- cgi 0.3.6
- csv 3.2.6
- date 3.3.3
- delegate 0.3.0
- did_you_mean 1.6.3
- digest 3.1.1
- drb 2.1.1
- english 0.7.2
- erb 4.0.2
- error_highlight 0.5.1
- etc 1.4.2
- fcntl 1.0.2
- fiddle 1.1.1
- fileutils 1.7.0
- forwardable 1.3.3
- getoptlong 0.2.0
- io-console 0.6.0
- io-nonblock 0.2.0
- io-wait 0.3.0
- ipaddr 1.2.5
- irb 1.6.2
- json 2.6.3
- logger 1.5.3
- mutex_m 0.1.2
- net-http 0.3.2
- net-protocol 0.2.1
- nkf 0.1.2
- open-uri 0.3.0
- open3 0.1.2
- openssl 3.1.0
- optparse 0.3.1
- ostruct 0.5.5
- pathname 0.2.1
- pp 0.4.0
- pstore 0.1.2
- psych 5.0.1
- racc 1.6.2
- rdoc 6.5.0
- readline-ext 0.1.5
- reline 0.3.2
- resolv 0.2.2
- resolv-replace 0.1.1
- securerandom 0.2.2
- set 1.0.3
- stringio 3.0.4
- strscan 3.0.5
- syntax_suggest 1.0.2
- syslog 0.1.1
- tempfile 0.1.3
- time 0.2.1
- timeout 0.3.1
- tmpdir 0.1.3
- tsort 0.1.1
- un 0.2.1
- uri 0.12.0
- weakref 0.1.2
- win32ole 1.8.9
- yaml 0.2.1
- zlib 3.0.0
更新了以下捆绑 gem。
- minitest 5.16.3
- power_assert 2.0.3
- test-unit 3.5.7
- net-ftp 0.2.0
- net-imap 0.3.4
- net-pop 0.1.2
- net-smtp 0.3.3
- rbs 2.8.2
- typeprof 0.21.3
- debug 1.7.1

有关默认 gem 或捆绑 gem 的详细信息，请参阅 GitHub 版本（如 Logger 的 GitHub 版本）或变更日志。

支持的平台¶ ↑

添加了 WebAssembly/WASI。有关详细信息，请参阅 wasm/README.md 和 ruby.wasm。[Feature #18462]

兼容性问题¶ ↑

目前，String#to_c 将一系列下划线视为 Complex 字符串的结尾。[Bug #19087]
现在，ENV.clone 和 ENV.dup 都会引发 TypeError 异常。[Bug #17767]

移除的常量¶ ↑

以下已弃用的常量被移除。

Fixnum 和 Bignum [Feature #12005]
Random::DEFAULT [Feature #17351]
Struct::Group
Struct::Passwd

移除的方法¶ ↑

以下已弃用的方法被移除。

Dir.exists? [Feature #17391]
File.exists? [Feature #17391]
Kernel#=~ [Feature #15231]
Kernel#taint, Kernel#untaint, Kernel#tainted? [Feature #16131]
Kernel#trust, Kernel#untrust, Kernel#untrusted? [Feature #16131]
Method#public?, Method#private?, Method#protected?, UnboundMethod#public?, UnboundMethod#private?, UnboundMethod#protected? [Bug #18729] [Bug #18751] [Bug #18435]

扩展库的源代码不兼容性¶ ↑

提供 PRNG（伪随机数生成器），Random 的子类的扩展库需要更新。请参阅下面的 [PRNG 更新] 获取更多信息。[Bug #19100]

错误打印器¶ ↑

Ruby 不再转义错误消息中的控制字符和反斜杠。[Feature #18367]

定义类/模块时的常量查找¶ ↑

当通过类/模块语句在 Object 类下直接定义类/模块时，如果已经存在一个通过 Module#include 定义的同名类/模块，在 Ruby 3.1 或更早版本中，该语句被视为“打开类”。从 Ruby 3.2 开始，会定义一个新的类。[Feature #18832]

标准库的兼容性问题¶ ↑

Psych 不再捆绑 libyaml 源代码。并且 Fiddle 也不再捆绑 libffi 源代码。用户需要通过 apt、yum、brew 等包管理器自行安装 libyaml/libffi 库。

Psych 和 fiddle 支持使用特定版本的 libyaml 和 libffi 源代码进行静态构建。您可以使用 libyaml-0.2.5 构建 psych，如下所示。
```
$ ./configure --with-libyaml-source-dir=/path/to/libyaml-0.2.5
```
您可以使用 libffi-3.4.4 构建 fiddle，如下所示。
```
$ ./configure --with-libffi-source-dir=/path/to/libffi-3.4.4
```
[Feature #18571]
检查 CGI::Cookie 中的 Cookie 名称/路径/域字符。[CVE-2021-33621]
URI.parse 在主机部分返回空字符串而不是 nil。[sec-156615]

C API 更新¶ ↑

更新的 C API¶ ↑

以下 API 已更新。

PRNG 更新

ruby/random.h 中的 rb_random_interface_t 已更新并进行了版本控制。使用此接口并为旧版本构建的扩展库需要通过添加 init_int32 函数进行重新构建。

添加的 C API¶ ↑

添加了 VALUE rb_hash_new_capa(long capa) 以创建具有所需容量的哈希。
添加了 rb_internal_thread_add_event_hook 和 rb_internal_thread_add_event_hook 以检测线程调度。以下事件可用
- RUBY_INTERNAL_THREAD_EVENT_STARTED
- RUBY_INTERNAL_THREAD_EVENT_READY
- RUBY_INTERNAL_THREAD_EVENT_RESUMED
- RUBY_INTERNAL_THREAD_EVENT_SUSPENDED
- RUBY_INTERNAL_THREAD_EVENT_EXITED
为调试器添加了 rb_debug_inspector_current_depth 和 rb_debug_inspector_frame_depth。

移除的 C API¶ ↑

以下已弃用的 API 被移除。

rb_cData 变量。
“taintedness” 和 “trustedness” 函数。[Feature #16131]

实现改进¶ ↑

修复了 Kernel#autoload 中的几个竞争条件。[Bug #18782]
引用常量的表达式的缓存失效现在更加细粒度。删除了 RubyVM.stat(:global_constant_state)，因为它与之前的缓存方案紧密相关，在之前的方案中，设置任何常量都会使系统中所有缓存失效。引入了新的键 :constant_cache_invalidations 和 :constant_cache_misses，以帮助使用 :global_constant_state 的用例。[Feature #18589]
引入了 Regexp 匹配的基于缓存的优化。[Feature #19104]
可变宽度分配现在默认启用。[Feature #18239]
添加了一种新的实例变量缓存机制，称为对象形状，它提高了大多数对象的内联缓存命中率，并允许我们生成非常高效的 JIT 代码。实例变量以一致的顺序定义的对象将获得最大的性能优势。[Feature #18776]
通过使用位图查找“可标记”对象来加速标记指令序列。此更改导致更快的 Major Collection。[Feature #18875]

JIT¶ ↑

YJIT¶ ↑

YJIT 不再是实验性的
- 已在生产工作负载上测试一年多，并证明相当稳定。
YJIT 现在支持 Linux、MacOS、BSD 和其他 UNIX 平台上的 x86-64 和 arm64/aarch64 CPU。
- 此版本带来了对 Mac M1/M2、AWS Graviton 和 Raspberry Pi 4 的支持。
现在构建 YJIT 需要 Rust 1.58.0+。[Feature #18481]
- 为了确保 CRuby 使用 YJIT 构建，请在运行 ./configure 之前安装 rustc >= 1.58.0
- 如果您遇到任何问题，请联系 YJIT 团队。
JIT 代码的物理内存是延迟分配的。与 Ruby 3.1 不同，Ruby 进程的 RSS 被最小化，因为 --yjit-exec-mem-size 分配的虚拟内存页面在实际被 JIT 代码使用之前不会映射到物理内存页面。
引入代码 GC，当 JIT 代码的内存消耗达到 --yjit-exec-mem-size 时，它会释放所有代码页。
- RubyVM::YJIT.runtime_stats 除了现有的 inline_code_size 和 outlined_code_size 键之外，还返回代码 GC 指标：code_gc_count、live_page_count、freed_page_count 和 freed_code_size。
由 RubyVM::YJIT.runtime_stats 生成的大部分统计信息现在都可以在发布版本中使用。
- 只需运行带有 --yjit-stats 的 ruby 即可计算并转储统计信息（会产生一些运行时开销）。
YJIT 现在经过优化，可以利用对象形状。[Feature #18776]
利用更细粒度的常量失效，在定义新常量时使更少的代码失效。[Feature #18589]
默认的 --yjit-exec-mem-size 已更改为 64 (MiB)。
默认的 --yjit-call-threshold 已更改为 30。

MJIT¶ ↑

MJIT 编译器在 Ruby 中以 ruby_vm/mjit/compiler 的形式重新实现。
MJIT 编译器在分叉的 Ruby 进程下执行，而不是在名为 MJIT worker 的本机线程中执行。[Feature #18968]
- 因此，不再支持 Microsoft Visual Studio (MSWIN)。
不再支持 MinGW。[Feature #18824]
将 --mjit-min-calls 重命名为 --mjit-call-threshold。
将默认的 --mjit-max-cache 从 10000 改回 100。