Skip to content
This commit does not belong to any branch on this repository, and may belong to a fork outside of the repository.

Commit e10103b

Browse files
authoredJan 30, 2025··
Translate Ruby 3.4.[01] released(zh_cn) (#3451)
1 parent 07e5abd commit e10103b

File tree

2 files changed

+362
-0
lines changed

2 files changed

+362
-0
lines changed
 
Lines changed: 323 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,323 @@
1+
---
2+
layout: news_post
3+
title: "Ruby 3.4.0 已发布"
4+
author: "naruse"
5+
translator: "GAO Jun"
6+
date: 2024-12-25 00:00:00 +0000
7+
lang: zh_cn
8+
---
9+
10+
{% assign release = site.data.releases | where: "version", "3.4.0" | first %}
11+
我们很高兴地宣布 Ruby {{ release.version }} 发布。
12+
Ruby 3.4 增加了块参数引用变量 `it`,使用 Prism 作为默认解析器,为 socket 库提供了 Happy Eyeballs Version 2 支持,
13+
改进了 YJIT,添加了模块化垃圾回收功能,及其他改进。
14+
15+
## 块中的 `it` 引用
16+
17+
当没有定义块参数名时,可以使用 `it` 引用块参数. [[Feature #18980]]
18+
19+
```ruby
20+
ary = ["foo", "bar", "baz"]
21+
22+
p ary.map { it.upcase } #=> ["FOO", "BAR", "BAZ"]
23+
```
24+
25+
`it``_1` 的功能类似。在块中使用 `_1` 时,读者可能会以为其他编号参数(`_2` 等)也会出现,这会给读者带来额外的阅读负担。
26+
因此,我们引入 `it` 作为一个便捷的别名。在简单的情况下(例如单行块),使用 `it` 可以显著提升可读性。
27+
28+
## Prism 现在是默认解析器
29+
30+
默认解析器从 parse.y 切换到 Prism。 [[Feature #20564]]
31+
32+
这是一项内部改进,用户应该不会注意到任何变化。如果您发现了任何兼容性问题,请报告给我们。
33+
34+
如果需要使用原来的解析器,可以使用命令行参数 `--parser=parse.y`
35+
36+
## socket 库现在支持 Happy Eyeballs Version 2 (RFC 8305)
37+
38+
socket 库现在支持 [Happy Eyeballs Version 2 (RFC 8305)](https://datatracker.ietf.org/doc/html/rfc8305),许多编程语言都提供这个最新版本的支持来优化网络连接。
39+
socket 库在 `TCPSocket.new` (`TCPSocket.open`) 和 `Socket.tcp` 中添加了支持。
40+
此项改进使得 Ruby 能够提供更高效可靠的网络连接,更适应现代互联网环境。
41+
42+
直至 Ruby 3.3,上述的方法会依次执行域名解析和尝试连接。通过现在的算法,将按下面的方式执行:
43+
44+
1. 并行执行 IPv6 和 IPv4 域名解析
45+
2. 尝试连接解析到的 IP 地址(IPv6 优先),以 250ms 的间隔进行并行尝试
46+
3. 返回第一个成功的连接,并取消其他连接
47+
48+
这样就保证了最小化网络延迟,即使特定的 IP 协议地址延迟或不可用。
49+
此功能默认启用,不需要额外的配置。如果要全局禁用此功能,可以设置环境变量 `RUBY_TCP_NO_FAST_FALLBACK=1`
50+
或者调用 `Socket.tcp_fast_fallback=false`。如果要在特定连接中禁用此功能,可以使用关键字参数 `fast_fallback: false`
51+
52+
## YJIT
53+
54+
### 摘要
55+
56+
* 在 x86-64 和 arm64 平台上的大多数基准测试中,都获得了更好的性能表现。
57+
* 减少了编译元数据的内存使用并提供了统一的内存限制。
58+
* 修复了多个错误。YJIT 现在更健壮了,并被更好地测试。
59+
60+
### 新功能
61+
62+
* 命令行参数
63+
* `--yjit-mem-size` (默认值为 128 MiB),用于设置统一的内存限制选项,并跟踪 YJIT 总的内存使用情况,
64+
这比旧的 `--yjit-exec-mem-size` 更直观。
65+
* `--yjit-log` 可以启用编译日志来跟踪被编译的内容。
66+
* Ruby API
67+
* `RubyVM::YJIT.log` 可以在运行时获取编译日志的尾部信息。
68+
* YJIT 统计信息
69+
* `RubyVM::YJIT.runtime_stats` 现在总是能在无效化、内联和元数据编码时提供额外的统计信息。
70+
71+
### 新优化
72+
73+
* 通过压缩上下文减少了存储 YJIT 元数据所需的内存
74+
* 为局部变量和方法参数分配寄存器
75+
* 当 YJIT 启用时,使用更多 Ruby 编写的核心原型类型:
76+
* 使用 Ruby 重写 `Array#each`, `Array#select`, `Array#map` 以提升性能 [[Feature #20182]]
77+
* 能够内联小型方法,诸如:
78+
* 空方法
79+
* 返回常量的方法
80+
* 返回 `self` 的方法
81+
* 直接返回某个参数的方法
82+
* 为更多运行时方法生成专用代码
83+
* 优化 `String#getbyte`, `String#setbyte` 等字符串方法
84+
* 优化位运算,加速低级 位/字节 操作
85+
* 在 multi-ractor 模式中,支持共享常量
86+
* 各种其他增量优化
87+
88+
## 模块化垃圾收集器
89+
90+
* 通过模块化垃圾收集功能,可以动态加载具体的垃圾收集器(GC)实现。
91+
若要启用此功能,可以在构建 Ruby 时,使用 `--with-modular-gc` 参数。
92+
运行时可以通过环境变量 `RUBY_GC_LIBRARY` 加载 GC 库。
93+
[[Feature #20351]]
94+
95+
* Ruby 内置的垃圾收集器已被拆分到单独的文件 `gc/default/default.c` 并通过 `gc/gc_impl.h` 中定义的 API 与 Ruby 进行交互。
96+
现在,内置的垃圾收集器也可以作为库进行构建:通过 `make modular-gc MODULAR_GC=default` 进行构建,
97+
并通过环境变量 `RUBY_GC_LIBRARY=default` 启用。 [[Feature #20470]]
98+
99+
* 提供了一个基于 [MMTk](https://www.mmtk.io/) 的实验性 GC 库。此库可以通过 `make modular-gc MODULAR_GC=mmtk` 进行构建,
100+
并通过环境变量 `RUBY_GC_LIBRARY=mmtk` 启用。构建的计算机需要 Rust 工具链。 [[Feature #20860]]
101+
102+
## 语言变化
103+
104+
* 在没有 `frozen_string_literal` 注释的文件中,当字符串字面量被修改时会发出警告。
105+
这些警告可以使用 `-W:deprecated` 或者通过设置 `Warning[:deprecated] = true` 来启用。
106+
如要禁用此变化,您可以在运行 Ruby 时,使用 `--disable-frozen-string-literal` 命令行参数。 [[Feature #20205]]
107+
108+
* 支持在调用方法时使用 `nil` 作为关键字展开参数。
109+
`**nil` 类似于 `**{}`,不传递关键字参数,也不调用任何转换方法。 [[Bug #20064]]
110+
111+
* 索引不再接受块传递。 [[Bug #19918]]
112+
113+
* 索引不再接受关键字参数。 [[Bug #20218]]
114+
115+
* 顶级名 `::Ruby` 现在是保留的,当启用 `Warning[:deprecated]` 时,如果对其进行定义将会被警告。 [[Feature #20884]]
116+
117+
## 核心类更新
118+
119+
注意:我们仅列出了核心类中值得注意的更新。
120+
121+
* Exception
122+
123+
* `Exception#set_backtrace` 现在接受 `Thread::Backtrace::Location` 数组。
124+
`Kernel#raise``Thread#raise``Fiber#raise` 也接受这个新格式。 [[Feature #13557]]
125+
126+
* GC
127+
128+
* 新增 `GC.config`,可以为垃圾收集器设置配置变量。 [[Feature #20443]]
129+
130+
* 新增 GC 配置参数 `rgengc_allow_full_mark` 。如果值为 `false`,GC 仅标记年轻对象。默认值为 `true`[[Feature #20443]]
131+
132+
* Ractor
133+
134+
* 允许在 Ractor 中使用 `require`。引入过程将在主 Ractor 中执行。
135+
可以通过 `Ractor._require(feature)` 在主 Ractor 中执行引入过程。 [[Feature #20627]]
136+
137+
* 新增 `Ractor.main?`[[Feature #20627]]
138+
139+
* 新增 `Ractor.[]``Ractor.[]=` 来访问当前 Ractor 关联存储的内容。 [[Feature #20715]]
140+
141+
* 新增 `Ractor.store_if_absent(key){ init }`,可以在进程安全的环境下初始化 ractor 关联的本地变量。 [[Feature #20875]]
142+
143+
* Range
144+
145+
* 当 range 不可枚举时,`Range#size` 将抛出 `TypeError`[[Misc #18984]]
146+
147+
148+
## 标准库更新
149+
150+
注意:我们仅列出了标准库中值得注意的更新。
151+
152+
* RubyGems
153+
* gem push 增加 `--attestation` 参数。此参数允许保存签名到 [sigstore.dev]
154+
155+
* Bundler
156+
* 新增 `lockfile_checksums` 参数,将校验和包含到新的 lockfiles 中
157+
* 新增 `--add-checksums` 向既有 lockfile 中增加校验和
158+
159+
* JSON
160+
161+
* 性能改进,`JSON.parse` 现在比 json-2.7.x 快约 1.5 倍。
162+
163+
* Tempfile
164+
165+
* `Tempfile.create` 新增关键字参数 `anonymous: true`
166+
`Tempfile.create(anonymous: true)` 会立即移除创建的临时文件。应用程序无需显式地移除临时文件。
167+
[[Feature #20497]]
168+
169+
* win32/sspi.rb
170+
171+
* 此库现在从 Ruby 代码仓库抽取到独立的代码仓库 [ruby/net-http-sspi][[Feature #20775]]
172+
173+
## 兼容性问题
174+
175+
注意:不包括问题补丁。
176+
177+
* 修改了错误信息和错误栈的显示。
178+
* 使用单引号(`'`)代替反勾号(`` ` ``)作为错误消息的起始引号。 [[Feature #16495]]
179+
* 在方法名前显示类名(仅当类具有永久名称时)。 [[Feature #19117]]
180+
* `Kernel#caller``Thread::Backtrace::Location` 等处也进行了相应更改。
181+
182+
```
183+
此前:
184+
test.rb:1:in `foo': undefined method `time' for an instance of Integer
185+
from test.rb:2:in `<main>'
186+
187+
现在:
188+
test.rb:1:in 'Object#foo': undefined method 'time' for an instance of Integer
189+
from test.rb:2:in `<main>'
190+
```
191+
192+
* Hash#inspect 的展示形式发生变化。 [[Bug #20433]]
193+
194+
* 键是 Symbol 时,使用现代的语法形式: `"{user: 1}"`
195+
* 其他类型的键值对在显示时,在 `=>` 前后加入空格:`'{"user" => 1}'`,此前显示时没有空格: `'{"user"=>1}'`
196+
197+
* Kernel#Float() 现在接受省略小数部分的数字字符串。 [[Feature #20705]]
198+
199+
```rb
200+
Float("1.") #=> 1.0 (此前会导致 ArgumentError)
201+
Float("1.E-1") #=> 0.1 (此前会导致 ArgumentError)
202+
```
203+
204+
* String#to_f 现在接受省略小数部分的数字字符串。注意,当指定指数时,返回结果与此前不同。 [[Feature #20705]]
205+
206+
```rb
207+
"1.".to_f #=> 1.0
208+
"1.E-1".to_f #=> 0.1 (此前会返回 1.0)
209+
```
210+
211+
* 移除 `Refinement#refined_class`[[Feature #19714]]
212+
213+
## 标准库兼容性问题
214+
215+
* DidYouMean
216+
217+
* 移除 `DidYouMean::SPELL_CHECKERS[]=``DidYouMean::SPELL_CHECKERS.merge!`
218+
219+
* Net::HTTP
220+
221+
* 移除下列已废弃常量:
222+
* `Net::HTTP::ProxyMod`
223+
* `Net::NetPrivate::HTTPRequest`
224+
* `Net::HTTPInformationCode`
225+
* `Net::HTTPSuccessCode`
226+
* `Net::HTTPRedirectionCode`
227+
* `Net::HTTPRetriableCode`
228+
* `Net::HTTPClientErrorCode`
229+
* `Net::HTTPFatalErrorCode`
230+
* `Net::HTTPServerErrorCode`
231+
* `Net::HTTPResponseReceiver`
232+
* `Net::HTTPResponceReceiver`
233+
234+
这些变量从 2012 年起已废弃。
235+
236+
* Timeout
237+
238+
* `Timeout.timeout` 的参数不允许负值。 [[Bug #20795]]
239+
240+
* URI
241+
242+
* 默认解析器从 RFC 2396 兼容切换到 RFC 3986 兼容。 [[Bug #19266]]
243+
244+
## C API 更新
245+
246+
* 移除 `rb_newobj``rb_newobj_of` (以及相关的宏 `RB_NEWOBJ``RB_NEWOBJ_OF``NEWOBJ``NEWOBJ_OF`)。 [[Feature #20265]]
247+
* 移除已废弃的函数 `rb_gc_force_recycle`[[Feature #18290]]
248+
249+
## 其他变化
250+
251+
* 如果传递了一个块给不使用块的方法时,在详细模式(`-w`)中将显示警告。 [[Feature #15554]]
252+
253+
* Ruby 对一些核心方法通过解释器和 JIT 进行了优化,诸如 `String.freeze``Integer#+`
254+
当这些方法被重定义时,解释器将发出性能警告(`-W:performance``Warning[:performance] = true`)。 [[Feature #20429]]
255+
256+
更多详情,可参见 [NEWS](https://docs.ruby-lang.org/en/3.4/NEWS_md.html)
257+
[提交日志](https://github.com/ruby/ruby/compare/v3_3_0...{{ release.tag }})。
258+
259+
自 Ruby 3.3.0 以来,这些变化共导致 [{{ release.stats.files_changed }} 个文件被更改,新增 {{ release.stats.insertions }} 行(+),删除 {{ release.stats.deletions }} 行(-)](https://github.com/ruby/ruby/compare/v3_3_0...{{ release.tag }}#file_bucket)!
260+
261+
圣诞快乐,节日快乐,享受 Ruby 3.4 的编程乐趣!
262+
263+
## 下载
264+
265+
* <{{ release.url.gz }}>
266+
267+
文件大小: {{ release.size.gz }}
268+
SHA1: {{ release.sha1.gz }}
269+
SHA256: {{ release.sha256.gz }}
270+
SHA512: {{ release.sha512.gz }}
271+
272+
* <{{ release.url.xz }}>
273+
274+
文件大小: {{ release.size.xz }}
275+
SHA1: {{ release.sha1.xz }}
276+
SHA256: {{ release.sha256.xz }}
277+
SHA512: {{ release.sha512.xz }}
278+
279+
* <{{ release.url.zip }}>
280+
281+
文件大小: {{ release.size.zip }}
282+
SHA1: {{ release.sha1.zip }}
283+
SHA256: {{ release.sha256.zip }}
284+
SHA512: {{ release.sha512.zip }}
285+
286+
## Ruby 是什么
287+
288+
Ruby 最初由 Matz (松本行弘,Yukihiro Matsumoto) 于 1993 年开发,
289+
现在以开源软件的形式开发。它可以在多个平台上运行,并在全球得到广泛使用,尤其是 Web 开发领域。
290+
291+
[Feature #13557]: https://bugs.ruby-lang.org/issues/13557
292+
[Feature #15554]: https://bugs.ruby-lang.org/issues/15554
293+
[Feature #16495]: https://bugs.ruby-lang.org/issues/16495
294+
[Feature #18290]: https://bugs.ruby-lang.org/issues/18290
295+
[Feature #18980]: https://bugs.ruby-lang.org/issues/18980
296+
[Misc #18984]: https://bugs.ruby-lang.org/issues/18984
297+
[Feature #19117]: https://bugs.ruby-lang.org/issues/19117
298+
[Bug #19266]: https://bugs.ruby-lang.org/issues/19266
299+
[Feature #19714]: https://bugs.ruby-lang.org/issues/19714
300+
[Bug #19918]: https://bugs.ruby-lang.org/issues/19918
301+
[Bug #20064]: https://bugs.ruby-lang.org/issues/20064
302+
[Feature #20182]: https://bugs.ruby-lang.org/issues/20182
303+
[Feature #20205]: https://bugs.ruby-lang.org/issues/20205
304+
[Bug #20218]: https://bugs.ruby-lang.org/issues/20218
305+
[Feature #20265]: https://bugs.ruby-lang.org/issues/20265
306+
[Feature #20351]: https://bugs.ruby-lang.org/issues/20351
307+
[Feature #20429]: https://bugs.ruby-lang.org/issues/20429
308+
[Feature #20443]: https://bugs.ruby-lang.org/issues/20443
309+
[Feature #20470]: https://bugs.ruby-lang.org/issues/20470
310+
[Feature #20497]: https://bugs.ruby-lang.org/issues/20497
311+
[Feature #20564]: https://bugs.ruby-lang.org/issues/20564
312+
[Bug #20620]: https://bugs.ruby-lang.org/issues/20620
313+
[Feature #20627]: https://bugs.ruby-lang.org/issues/20627
314+
[Feature #20705]: https://bugs.ruby-lang.org/issues/20705
315+
[Feature #20715]: https://bugs.ruby-lang.org/issues/20715
316+
[Feature #20775]: https://bugs.ruby-lang.org/issues/20775
317+
[Bug #20795]: https://bugs.ruby-lang.org/issues/20795
318+
[Bug #20433]: https://bugs.ruby-lang.org/issues/20433
319+
[Feature #20860]: https://bugs.ruby-lang.org/issues/20860
320+
[Feature #20875]: https://bugs.ruby-lang.org/issues/20875
321+
[Feature #20884]: https://bugs.ruby-lang.org/issues/20884
322+
[sigstore.dev]: https://www.sigstore.dev/
323+
[ruby/net-http-sspi]: https://github.com/ruby/net-http-sspi
Lines changed: 39 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,39 @@
1+
---
2+
layout: news_post
3+
title: "Ruby 3.4.1 已发布"
4+
author: "naruse"
5+
translator: "GAO Jun"
6+
date: 2024-12-25 00:00:00 +0000
7+
lang: zh_cn
8+
---
9+
10+
Ruby 3.4.1 已发布。
11+
12+
此版本修正了版本的描述。
13+
14+
更多信息可以参考 [GitHub releases](https://github.com/ruby/ruby/releases/tag/v3_4_1)
15+
16+
## 下载
17+
18+
{% assign release = site.data.releases | where: "version", "3.4.1" | first %}
19+
20+
* <{{ release.url.gz }}>
21+
22+
文件大小: {{ release.size.gz }}
23+
SHA1: {{ release.sha1.gz }}
24+
SHA256: {{ release.sha256.gz }}
25+
SHA512: {{ release.sha512.gz }}
26+
27+
* <{{ release.url.xz }}>
28+
29+
文件大小: {{ release.size.xz }}
30+
SHA1: {{ release.sha1.xz }}
31+
SHA256: {{ release.sha256.xz }}
32+
SHA512: {{ release.sha512.xz }}
33+
34+
* <{{ release.url.zip }}>
35+
36+
文件大小: {{ release.size.zip }}
37+
SHA1: {{ release.sha1.zip }}
38+
SHA256: {{ release.sha256.zip }}
39+
SHA512: {{ release.sha512.zip }}

0 commit comments

Comments
 (0)
Please sign in to comment.