NEWS for Ruby 3.1.0¶ ↑

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

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

语言变更¶ ↑

• 如果块只传递给另一个方法，块参数现在可以是匿名的。[Feature #11256]

  def foo(&)
    bar(&)
  end
  

• Pin 运算符现在接受表达式。[功能 #17411]

  Prime.each_cons(2).lazy.find_all{_1 in [n, ^(n + 2)]}.take(3).to_a
  #=> [[3, 5], [5, 7], [11, 13]]
  

• Pin 运算符现在支持实例、类和全局变量。[功能 #17724]

  @n = 5
  Prime.each_cons(2).lazy.find{_1 in [n, ^@n]}
  #=> [3, 5]
  

• 单行模式匹配不再是实验性的。

• 单行模式匹配中可以省略括号。[功能 #16182]

  [0, 1] => _, x
  {y: 2} => y:
  x #=> 1
  y #=> 2
  

• 多重赋值的求值顺序已与单一赋值的求值顺序保持一致。对于单一赋值，Ruby 使用从左到右的求值顺序。使用以下代码

  foo[0] = bar
  

  使用以下求值顺序

  1. foo

  2. bar

  3. []= 在 foo 的结果上调用

  在 Ruby 3.1.0 之前，多重赋值不遵循此求值顺序。使用以下代码

  foo[0], bar.baz = a, b
  

  3.1.0 之前的 Ruby 版本将按以下顺序求值

  1. a

  2. b

  3. foo

  4. []= 在 foo 的结果上调用

  5. bar

  6. baz= 在 bar 的结果上调用

  从 Ruby 3.1.0 开始，求值顺序现在与单一赋值一致，左侧在右侧之前求值

  1. foo

  2. bar

  3. a

  4. b

  5. []= 在 foo 的结果上调用

  6. baz= 在 bar 的结果上调用

  [Bug #4443]

• Hash 字面量和关键字参数中的值可以省略。[功能 #14579]

  例如，

  • {x:, y:} 是 {x: x, y: y} 的语法糖。

  • foo(x:, y:) 是 foo(x: x, y: y) 的语法糖。

  常量名、局部变量名和方法名可以作为键名。请注意，即使是像 self 这样的伪变量名，保留字也被视为局部变量名或方法名。

• 非主 Ractor 可以获取类/模块的实例变量（ivar），如果 ivar 引用可共享对象。[功能 #17592]

• 在无限方法定义中允许使用命令语法，即你现在可以写 def foo = puts "Hello"。请注意，private def foo = puts "Hello" 无法解析。[功能 #17398]

命令行选项¶ ↑

• --disable-gems 现在明确声明为“仅用于调试”。不要在任何实际代码库中使用它。[功能 #17684]

核心类更新¶ ↑

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

• 数组

  • Array#intersect? 已添加。[功能 #15198]

• 类

  • Class#subclasses 返回一个包含直接继承自接收者的类的数组，不包括单例类。[Feature #18273]

    class A; end
    class B < A; end
    class C < B; end
    class D < A; end
    A.subclasses    #=> [D, B]
    B.subclasses    #=> [C]
    C.subclasses    #=> []
    

• Enumerable

  • Enumerable#compact 已添加。[Feature #17312]

  • Enumerable#tally 现在接受一个可选的哈希表进行计数。[Feature #17744]

  • Enumerable#each_cons 和 each_slice 返回接收者。[GH-1509]

    [1, 2, 3].each_cons(2){}
    # 3.0 => nil
    # 3.1 => [1, 2, 3]
    
    [1, 2, 3].each_slice(2){}
    # 3.0 => nil
    # 3.1 => [1, 2, 3]
    

• Enumerator::Lazy

  • Enumerator::Lazy#compact 已添加。[Feature #17312]

• File

  • File.dirname 现在接受一个可选参数，用于指定要剥离的路径组件级别。[Feature #12194]

• GC

  • "GC.measure_total_time = true" 启用 GC 的测量。测量可能会引入开销。默认情况下启用。 GC.measure_total_time 返回当前设置。 GC.stat[:time] 或 GC.stat(:time) 返回以毫秒为单位的测量时间。[[Feature #10917]]

  • GC.total_time 返回以纳秒为单位的测量时间。[[Feature #10917]]

• Integer

  • Integer.try_convert 已添加。[Feature #15211]

• Kernel

  • Kernel#load 现在接受一个模块作为第二个参数，并将使用给定模块作为顶层模块加载文件。[Feature #6210]

• Marshal

  • Marshal.load 现在接受一个 freeze: true 选项。所有返回的对象都被冻结，除了 Class 和 Module 实例。字符串被去重。[Feature #18148]

• MatchData

  • MatchData#match 已添加 [Feature #18172]

  • MatchData#match_length 已添加 [Feature #18172]

• Method / UnboundMethod

  • Method#public?, Method#private?, Method#protected?, UnboundMethod#public?, UnboundMethod#private?, UnboundMethod#protected? 已添加。[Feature #11689]

• 模块

  • Module#prepend 现在如果接收者已经包含了参数，则会修改祖先链。 Module#prepend 仍然不会修改祖先链，如果接收者已经预先添加了参数。 [Bug #17423]

  • Module#private、public、protected 和 module_function 现在将返回它们的 arguments。如果给定单个参数，则返回该参数。如果没有给出参数，则返回 nil。如果给出多个参数，则将它们作为数组返回。 [Feature #12495]

• 进程

  • Process._fork 已添加。这是 fork(2) 的核心方法。不要直接调用此方法；它由现有的 fork 方法调用：Kernel.#fork、Process.fork 和 IO.popen(“-”)。应用程序监控库可以覆盖此方法以挂钩 fork 事件。 [Feature #17795]

• 结构

  • 仅将关键字参数传递给 Struct#initialize 会发出警告。您需要使用 Hash 字面量来设置 Hash 到第一个成员。 [Feature #16806]

  • StructClass#keyword_init? 已添加 [Feature #18008]

• 字符串

  • 将 Unicode 版本更新为 13.0.0 [Feature #17750]，并将 Emoji 版本更新为 13.0 [Feature #18029]

  • String#unpack 和 String#unpack1 现在接受 offset: 关键字参数，以便在跳过任意数量的字节后开始解包。如果 offset 超出字符串边界，则会引发 ArgumentError。 [Feature #18254]

• 线程

  • Thread#native_thread_id 已添加。 [Feature #17853]

• Thread::Backtrace

  • Thread::Backtrace.limit，它返回由 --backtrace-limit 命令行选项设置的限制回溯长度的值，已添加。 [Feature #17479]

• Thread::Queue

  • Thread::Queue.new 现在接受 Enumerable 的初始值。 [Feature #17327]

• 时间

  • Time.new 现在接受可选的 in: 关键字参数用于时区，以及 Time.at 和 Time.now，因此现在您可以省略 Time.new 的次要参数。 [Feature #17485]

    Time.new(2021, 12, 25, in: "+07:00")
    #=> 2021-12-25 00:00:00 +0700
    

    同时，时间组件字符串现在被更严格地转换为整数。

    Time.new(2021, 12, 25, "+07:30")
    #=> invalid value for Integer(): "+07:30" (ArgumentError)
    

    Ruby 3.0 或更早版本返回了可能意想不到的结果 2021-12-25 07:00:00，而不是 2021-12-25 07:30:00 或 2021-12-25 00:00:00 +07:30。

  • Time#strftime 支持 RFC 3339 UTC 用于未知偏移量本地时间，-0000，作为 %-z。[功能 #17544]

• 跟踪点

  • TracePoint.allow_reentry 被添加以允许在 TracePoint 回调期间重新进入。[功能 #15912]

• $LOAD_PATH

  • $LOAD_PATH.resolve_feature_path 不会引发异常。[功能 #16043]

• Fiber 调度器

  • 添加对使用 address_resolve 钩子的 Addrinfo.getaddrinfo 的支持。[功能 #17370]

  • 使用 timeout_after 钩子引入非阻塞 Timeout.timeout。[功能 #17470]

  • 引入新的调度器钩子 io_read 和 io_write 以及用于零拷贝读写的低级 IO::Buffer。[功能 #18020]

  • IO 钩子 io_wait、io_read、io_write，尽可能接收原始的 IO 对象。[错误 #18003]

  • 使 Monitor 成为线程安全的。[错误 #17827]

  • 用 pthread 实现替换复制协程。[功能 #18015]

• 细化

  • 表示由 Module#refine 创建的模块的新类。include 和 prepend 已被弃用，并添加了 import_methods 来代替。[错误 #17429]

标准库更新¶ ↑

• 以下默认 gem 已更新。

  • RubyGems 3.3.3

  • base64 0.1.1

  • benchmark 0.2.0

  • bigdecimal 3.1.1

  • bundler 2.3.3

  • cgi 0.3.1

  • csv 3.2.2

  • date 3.2.2

  • did_you_mean 1.6.1

  • digest 3.1.0

  • drb 2.1.0

  • erb 2.2.3

  • error_highlight 0.3.0

  • etc 1.3.0

  • fcntl 1.0.1

  • fiddle 1.1.0

  • fileutils 1.6.0

  • find 0.1.1

  • io-console 0.5.10

  • io-wait 0.2.1

  • ipaddr 1.2.3

  • irb 1.4.1

  • json 2.6.1

  • logger 1.5.0

  • net-http 0.2.0

  • net-protocol 0.1.2

  • nkf 0.1.1

  • open-uri 0.2.0

  • openssl 3.0.0

  • optparse 0.2.0

  • ostruct 0.5.2

  • pathname 0.2.0

  • pp 0.3.0

  • prettyprint 0.1.1

  • psych 4.0.3

  • racc 1.6.0

  • rdoc 6.4.0

  • readline 0.0.3

  • readline-ext 0.1.4

  • reline 0.3.0

  • resolv 0.2.1

  • rinda 0.1.1

  • ruby2_keywords 0.0.5

  • securerandom 0.1.1

  • set 1.0.2

  • stringio 3.0.1

  • strscan 3.0.1

  • tempfile 0.1.2

  • time 0.2.0

  • timeout 0.2.0

  • tmpdir 0.1.2

  • un 0.2.0

  • uri 0.11.0

  • yaml 0.2.0

  • zlib 2.1.1

  • RubyGems 3.3.3

  • base64 0.1.1

  • benchmark 0.2.0

  • bigdecimal 3.1.1

  • bundler 2.3.3

  • cgi 0.3.1

  • csv 3.2.2

  • date 3.2.2

  • did_you_mean 1.6.1

  • digest 3.1.0

  • drb 2.1.0

  • erb 2.2.3

  • error_highlight 0.3.0

  • etc 1.3.0

  • fcntl 1.0.1

  • fiddle 1.1.0

  • fileutils 1.6.0

  • find 0.1.1

  • io-console 0.5.10

  • io-wait 0.2.1

  • ipaddr 1.2.3

  • irb 1.4.1

  • json 2.6.1

  • logger 1.5.0

  • net-http 0.2.0

  • net-protocol 0.1.2

  • nkf 0.1.1

  • open-uri 0.2.0

  • openssl 3.0.0

  • optparse 0.2.0

  • ostruct 0.5.2

  • pathname 0.2.0

  • pp 0.3.0

  • prettyprint 0.1.1

  • psych 4.0.3

  • racc 1.6.0

  • rdoc 6.4.0

  • readline 0.0.3

  • readline-ext 0.1.4

  • reline 0.3.0

  • resolv 0.2.1

  • rinda 0.1.1

  • ruby2_keywords 0.0.5

  • securerandom 0.1.1

  • set 1.0.2

  • stringio 3.0.1

  • strscan 3.0.1

  • tempfile 0.1.2

  • time 0.2.0

  • timeout 0.2.0

  • tmpdir 0.1.2

  • un 0.2.0

  • uri 0.11.0

  • yaml 0.2.0

  • zlib 2.1.1

• 以下捆绑的 gem 已更新。

  • minitest 5.15.0

  • power_assert 2.0.1

  • rake 13.0.6

  • test-unit 3.5.3

  • rexml 3.2.5

  • rbs 2.0.0

  • typeprof 0.21.1

  • minitest 5.15.0

  • power_assert 2.0.1

  • rake 13.0.6

  • test-unit 3.5.3

  • rexml 3.2.5

  • rbs 2.0.0

  • typeprof 0.21.1

• 以下默认 gem 现在是捆绑 gem。

  • net-ftp 0.1.3

  • net-imap 0.2.2

  • net-pop 0.1.1

  • net-smtp 0.3.1

  • matrix 0.4.2

  • prime 0.1.2

  • debug 1.4.0

  • net-ftp 0.1.3

  • net-imap 0.2.2

  • net-pop 0.1.1

  • net-smtp 0.3.1

  • matrix 0.4.2

  • prime 0.1.2

  • debug 1.4.0

• 以下 gem 已从 Ruby 标准库中删除。

  • dbm

  • gdbm

  • tracer

  • dbm

  • gdbm

  • tracer

• Coverage 测量现在支持挂起。您可以使用 Coverage.suspend 暂时停止测量，并使用 Coverage.resume 重新启动它。详情请参见 [Feature #18176]。

• Random::Formatter 已移至 random/formatter.rb，因此您无需使用 SecureRandom 即可使用 Random#hex、Random#base64 等。[Feature #18190]

兼容性问题¶ ↑

注意：不包括功能错误修复。

• rb_io_wait_readable、rb_io_wait_writable 和 rb_wait_for_single_fd 已弃用，建议使用 rb_io_maybe_wait_readable、rb_io_maybe_wait_writable 和 rb_io_maybe_wait。rb_thread_wait_fd 和 rb_thread_fd_writable 已弃用。[Bug #18003]

标准库兼容性问题¶ ↑

• ERB#initialize 即使没有 -w 也会警告 safe_level 和后面的参数。[Feature #14256]

• lib/debug.rb 已被 debug.gem 替换。

• lib/pp.rb 中的 Kernel#pp 默认使用 IO#winsize 的宽度。这意味着输出宽度会根据您的终端大小自动更改。[Feature #12913]

• Psych 4.0 将 Psych.load 默认更改为 safe_load。您可能需要使用 Psych 3.3.2 迁移到此行为。[Bug #17866]

C API 更新¶ ↑

• 已记录。[GH-4815]

• rb_gc_force_recycle 已被弃用，并已更改为无操作。[功能 #18290]

实现改进¶ ↑

• 引入了内联缓存机制来读取类变量。[功能 #17763]

• instance_eval 和 instance_exec 现在仅在需要时才分配单例类，避免了额外的对象并提高了性能。[GH-5146]

• Struct 访问器的性能得到了提升。[GH-5131]

• mandatory_only? 内置特殊形式，用于提高内置方法的性能。[GH-5112]

• 垃圾收集器中的实验性功能可变宽度分配。此功能默认情况下处于关闭状态，可以通过使用标志USE_RVARGC=1 编译 Ruby 来启用。[功能 #18045] [功能 #18239]

JIT¶ ↑

• 将 Ruby 3.0 的--jit 重命名为--mjit，并将--jit 作为别名用于非 Windows x86-64 平台上的--yjit，以及其他平台上的--mjit。

MJIT¶ ↑

• 默认的--mjit-max-cache 从 100 更改为 10000。

• 当为类事件启用 TracePoint 时，JIT 代码不再被取消。

• JIT 编译器不再跳过编译超过 1000 条指令的方法。

• 当由于使用 TracePoint 或 GC.compact 而禁用 JIT 代码时，--mjit-verbose 和 --mjit-warning 输出“JIT 取消”。

YJIT：新的实验性进程内 JIT 编译器¶ ↑

新的 JIT 编译器作为实验性功能提供。[功能 #18229]

请参阅 这篇博文，介绍了该项目。

• 默认情况下禁用，使用--yjit 命令行选项启用 YJIT。

• 基于现实世界软件的基准测试的性能改进，在 railsbench 上提高了 22%，在 liquid-render 上提高了 39%。

• 快速预热时间。

• 目前仅限于类 Unix x86-64 平台。

静态分析¶ ↑

RBS¶ ↑

• 泛型类型参数可以有边界 (PR).

  # `T` must be compatible with the `_Output` interface.
  # `PrettyPrint[String]` is ok, but `PrettyPrint[Integer]` is a type error.
  class PrettyPrint[T < _Output]
    interface _Output
      def <<: (String) -> void
    end
  
    attr_reader output: T
  
    def initialize: (T output) -> void
  end

• 类型别名可以是泛型的。 (PR)

  # Defines a generic type `list`.
  type list[T] = [ T, list[T] ]
               | nil
  
  type str_list = list[String]
  type int_list = list[Integer]

• rbs collection 已被引入用于管理 gem 的 RBS。

• 许多内置库和标准库的签名已被添加或更新。

• 它还包含许多错误修复和性能改进。

查看 CHANGELOG.md 获取更多信息。

TypeProf¶ ↑

• 实验性 IDE 支持 已实现。

• 自 Ruby 3.0.0 以来，许多错误修复和性能改进。

调试器¶ ↑

• 一个新的调试器 debug.gem 已捆绑。debug.gem 是一个快速调试器实现，它提供了许多功能，例如远程调试、彩色 REPL、IDE（VSCode）集成等等。它取代了 lib/debug.rb 标准库。

• rdbg 命令也被安装到 bin/ 目录中，用于启动和控制调试执行。

error_highlight¶ ↑

一个名为 error_highlight 的内置 gem 已被引入。它在回溯中显示细粒度的错误位置。

示例：title = json[:article][:title]

如果 json 为 nil，则显示

$ ruby test.rb
test.rb:2:in `<main>': undefined method `[]' for nil:NilClass (NoMethodError)

title = json[:article][:title]
            ^^^^^^^^^^

如果 json[:article] 返回 nil，则显示

$ ruby test.rb
test.rb:2:in `<main>': undefined method `[]' for nil:NilClass (NoMethodError)

title = json[:article][:title]
                      ^^^^^^^^

此功能默认启用。您可以使用命令行选项 --disable-error_highlight 禁用它。查看 存储库 获取详细信息。

IRB 自动完成和文档显示¶ ↑

IRB 现在具有自动完成功能，您只需输入代码，就会出现完成候选对话框。您可以使用 Tab 和 Shift+Tab 在上下移动。

如果在您选择完成候选时安装了文档，则文档对话框将出现在完成候选对话框旁边，显示部分内容。您可以按 Alt+d 阅读完整文档。

其他更改¶ ↑

• 添加了 lib/objspace/trace.rb，它是一个用于跟踪对象分配的工具。只需包含此文件，跟踪就会立即开始。只需使用 Kernel#p，您就可以调查对象是在哪里创建的。请注意，仅仅包含此文件就会带来很大的性能开销。这仅用于调试目的。不要在生产环境中使用它。[Feature #17762]

• 现在，在终结器中引发的异常将被打印到 STDERR，除非 $VERBOSE 为 nil。[Feature #17798]

• ruby -run -e httpd 显示访问的 URL。[Feature #17847]

• 添加 ruby -run -e colorize 以使用 IRB::Color.colorize_code 对 Ruby 代码进行着色。