Skip to content

Commit 8269e75

Browse files
timfanda35bugtender
timfanda35
authored and
bugtender
committed
Translate Ruby 3.4.0 and 3.4.1 Released (zh_tw)
1 parent a17c89b commit 8269e75

File tree

2 files changed

+362
-0
lines changed

2 files changed

+362
-0
lines changed

‎zh_tw/news/_posts/2024-12-25-ruby-3-4-0-released.md

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: "Bear Su"
6+
date: 2024-12-25 00:00:00 +0000
7+
lang: zh_tw
8+
---
9+
10+
{% assign release = site.data.releases | where: "version", "3.4.0" | first %}
11+
我們很高興宣布 Ruby {{ release.version }} 發佈了。 Ruby 3.4 加入了 `it` 區塊參數參考變數，
12+
將 Prism 作為預設的解析氣，為 socket 函式庫加入 Happy Eyeballs Version 2 支援，改進 YJIT，加入 Modular GC，與其他更多.
13+
14+
## 導入 `it`
15+
16+
加入 `it` 參考沒有變數名稱的區塊參數。 [[Feature #18980]]
17+
18+
```ruby
19+
ary = ["foo", "bar", "baz"]
20+
21+
p ary.map { it.upcase } #=> ["FOO", "BAR", "BAZ"]
22+
```
23+
24+
`it` 行為與 `_1` 類似。當意圖在區塊中只想使用 `_1` 時，其他編號的參數例如 `_2` 也可能會出現，這會對讀者造成額外的認知負擔。因此 `it` 被導入作為一個方便的別名。在使用 `it` 能表示自身的簡單情境下使用 `it`，例如在單行區塊中。
25+
26+
## Prism 先在是預設解析器
27+
28+
預設的解析器從 parse.y 切換為 Prism。 [[Feature #20564]]
29+
30+
這是一項內部改進，使用者應該看不到什麼變化。如果您發現任何相容性問題，請向我們回報。
31+
32+
若要使用傳統的解析器，請使用指令列參數 `--parser=parse.y`。
33+
34+
## socket 函式庫新功能 Happy Eyeballs Version 2 (RFC 8305)
35+
36+
socket 函式庫引入新功能[Happy Eyeballs 版本2 (RFC 8305)](https://datatracker.ietf.org/doc/html/rfc8305)，這是在許多程式語言廣泛採用實現更好連接的最新標準化版本，在 `TCPSocket.new`（`TCPSocket.open`）和 `Socket.tcp`。
37+
這項改進使 Ruby 能夠提供高效、可靠的網路連接，適應現代網路環境。
38+
39+
在 Ruby 3.3 之前，這些方法會連續執行名稱解析和連接。透過該演算法，它們現在的運作方式如下：
40+
41+
1. 同時執行 IPv6 和 IPv4 名稱解析
42+
2. 嘗試連接已解析的 IP 位址，優先考慮 IPv6，並以 250 毫秒間隔錯開平行連線嘗試。
43+
3. 回傳第一個成功的連接，同時取消任何其他連接
44+
45+
這樣可確保即使特定協定或 IP 位址發生延遲或不可用，也能將連線延遲降至最低。
46+
47+
此功能預設為啟用，因此無需額外設定即可使用。若要全域停用此功能，請設定環境變數 `RUBY_TCP_NO_FAST_FALLBACK=1` 或呼叫 `Socket.tcp_fast_fallback=false`。或者，若要針對單一方法停用此功能，請使用關鍵字引數 `fast_fallback: false`。
48+
49+
## YJIT
50+
51+
### TL;DR
52+
53+
* 在 x86-64 與 arn64 平台上的大多數基準測試都有更好的效能
54+
* 減少編輯後設資料的的記憶體用量
55+
* 修復多個錯誤。YJIT 現在更加勇健且有更好的測試。
56+
57+
### 新功能
58+
59+
* 指令列選項
60+
* 透過 `--yjit-mem-size` 指令選項新增統一記憶體限制 (預設 128MiB)，該功能追蹤總 YJIT 記憶體用量，而且比舊的 `--yjit-exec-mem-size` 更為直觀
61+
* 透過 `--yjit-log` 加入編譯紀錄來追蹤哪些被編譯
62+
* Ruby API
63+
* 可以在運行環境透過 `RubyVM::YJIT.log` 取得紀錄結尾
64+
* YJIT stats
65+
* 現在總是可以透過 `RubyVM::YJIT.runtime_stats` 取得更多統計數據：
66+
invalidation、inlining、和 metadata encoding。
67+
68+
### 新的改善
69+
70+
* 透過壓縮上下文來減少儲存 YJIT 後設資料所需的記憶體空間
71+
* 改善後的分配器能為本地變數分配暫存器
72+
* 當啟用 YJIT 時，使用更多用 Ruby 邊寫的核心程式：
73+
* 使用 Ruby 改寫`Array#each`、`Array#select`、`Array#map` 提高效能 [[Feature #20182]].
74+
* 能夠內聯小型/簡單的方法，例如：
75+
* 空方法
76+
* 回傳常數的方法
77+
* 回傳 `self` 的方法
78+
* 直接回傳參數的方法
79+
* 適用於更多執行環境方法的程式碼產生器
80+
* 改善 `String#getbyte`、`String#setbyte` 和其他字串方法
81+
* 改善位元計算來加速低階位元/位元組操作
82+
* 各種其他的增量改善
83+
84+
## 模組化垃圾收集器
85+
86+
* 模組化垃圾收集器功能可以動態載入替代垃圾收集器實作。
87+
要啟用該功能，在建置 Ruby 時設定 `--with-modular-gc`。
88+
垃圾收集器函式庫可以在運行環境使用環境變數 `RUBY_GC_LIBRARY` 載入。
89+
[[Feature #20351]]
90+
91+
* Ruby 內建的垃圾收集器已經切分成不同的檔案 `gc/default/default.c`，並使用在 `gc/gc_impl.h` 定義的 API 與 Ruby 互動。
92+
內建的垃圾收集器現在也可以用 `make modular-gc MODULAR_GC=default` 建置為函式庫，並使用環境變數 `RUBY_GC_LIBRARY=default` 啟用。[[Feature #20470]]
93+
94+
* 基於 [MMTk](https://www.mmtk.io/) 提供了一個實驗性的垃圾收集器函式庫。
95+
該垃圾收集器函式庫可以使用 `make modular-gc MODULAR_GC=mmtk` 建置，並使用環境變數 `RUBY_GC_LIBRARY=mmtk` 啟用。
96+
建置主機上需要有 Rust 工具鏈。[[Feature #20860]]
97+
98+
## 語法變更
99+
100+
* 沒有 `frozen_string_literal` 註解的檔案中的字串文字，現在行為會跟被凍結一樣。如果它們被修改則會發出棄用警告。
101+
這些警告可以透過 `-W:deprecated` 或 `Warning[:deprecated] = true` 啟用。
102+
若要停用此變更，您可以在執行 Ruby 時加上參數 `--disable-frozen-string-literal`。 [[Feature #20205]]
103+
104+
* 現在呼叫方法支援使用 Keyword splatting `nil`。
105+
`**nil` 的處理方式與 `**{}` 類似，不會傳遞 keywords，也不會呼叫任何轉換方法。 [[Bug #20064]]
106+
107+
* Block passing 不再允許作為索引。 [[Bug #19918]]
108+
109+
* 不定長度參數不再允許作為索引。 [[Bug #20218]]
110+
111+
* 頂級名稱 `::Ruby` 現在被保留，且會在 `Warning[:deprecated]` 時警告。 [[Feature #20884]]
112+
113+
## 核心類別更新
114+
115+
注意：我們只列出特別的類別更新。
116+
117+
* Exception
118+
119+
* `Exception#set_backtrace` 現在可接受 `Thread::Backtrace::Location` 陣列。
120+
`Kernel#raise`、`Thread#raise` 和 `Fiber#raise` 也接受同樣的新格式。 [[Feature #13557]]
121+
122+
* GC
123+
124+
* 加入 `GC.config` 允許在垃圾收集器中指定設定變數。[[Feature #20443]]
125+
126+
* 引入 GC 設定參數 `rgengc_allow_full_mark`。當 `false` GC 只會標記年輕的物件。預設為 `true`。[[Feature #20443]]
127+
128+
* Ractor
129+
130+
* 在 Ractor 中允許使用 `require`。該 requiring 程序會在主要 Ractor 執行。
131+
加入 `Ractor._require(feature)` 在主要 Ractor 執行 requiring 程序。[[Feature #20627]]
132+
133+
* 加入 `Ractor.main?`。 [[Feature #20627]]
134+
135+
* 加入 `Ractor.[]` 和 `Ractor.[]=` 存取目前 Ractor 的 ractor local storage。[[Feature #20715]]
136+
137+
* 加入 `Ractor.store_if_absent(key){ init }` 在執行緒安全下初始化 ractor 本地變數。[[Feature #20875]]
138+
139+
* Range
140+
141+
* `Range#size` 如果 range 無法迭代的話，現在會拋出 `TypeError`。 [[Misc #18984]]
142+
143+
144+
## 標準函式庫更新
145+
146+
注意：我們只列出特別的標準函式庫更新。
147+
148+
* RubyGems
149+
* gem push 新增 `--attestation` 選項。它允許將簽章儲存到 [sigstore.dev]
150+
151+
* Bundler
152+
* 新增 `lockfile_checksums` 設定，可以在新的 lockfiles 包含 checksums。
153+
* bundle lock 新增 `--add-checksums` 選項將 checksums 加入到現有的 lockfile
154+
155+
* JSON
156+
157+
* `JSON.parse` 比 json-2.7.x 相比效能提升約 1.5 倍。
158+
159+
* Tempfile
160+
161+
* Tempfile.create 實作了關鍵字參數 `anonymous: true`。
162+
`Tempfile.create(anonymous: true)` 會立即刪除該建立的暫存檔案。
163+
因此應用程式不需要自行刪除該檔案。
164+
[[Feature #20497]]
165+
166+
* win32/sspi.rb
167+
168+
* 這個函式庫已從 Ruby 儲存庫分離至 [ruby/net-http-sspi]。
169+
[[Feature #20775]]
170+
171+
## 相容性問題
172+
173+
注意：不包含功能問題的修正。
174+
175+
* 錯誤訊息與 backtrace 的顯示改變。
176+
* 使用單引號 (`'`) 取代反引號 (`` ` ``) 作為起始引號。 [[Feature #16495]]
177+
* 在方法名稱前顯示類別名稱 (僅當類別有固定名稱時)。 [[Feature #19117]]
178+
* `Kernel#caller`、`Thread::Backtrace::Location` 的方法等等，也做了對應的改變。
179+
180+
```
181+
舊:
182+
test.rb:1:in `foo': undefined method `time' for an instance of Integer
183+
from test.rb:2:in `<main>'
184+
185+
新:
186+
test.rb:1:in 'Object#foo': undefined method 'time' for an instance of Integer
187+
from test.rb:2:in '<main>'
188+
```
189+
190+
* Hash#inspect 渲染變更。 [[Bug #20433]]
191+
192+
* 符號鍵將會以現代符號鍵語法顯示： `"{user: 1}"`
193+
* 其他鍵現在會在 `=>` 周圍加上空白：`'{"user" => 1}'`，之前沒有將上空白：`'{"user"=>1}'`
194+
195+
* Kernel#Float() 現在接受忽略小數位數的數值字串。 [[Feature #20705]]
196+
197+
```rb
198+
Float("1.") #=> 1.0 (之前，拋出 ArgumentError)
199+
Float("1.E-1") #=> 0.1 (之前，拋出 ArgumentError)
200+
```
201+
202+
* String#to_f 現在接受忽略小數位數的數值字串。注意指定指數後結果將會改變。[[Feature #20705]]
203+
204+
```rb
205+
"1.".to_f #=> 1.0
206+
"1.E-1".to_f #=> 0.1 (之前，回傳 1.0)
207+
```
208+
209+
* Refinement#refined_class 已被移除。 [[Feature #19714]]
210+
211+
## 標準函式庫相容性問題
212+
213+
* DidYouMean
214+
215+
* `DidYouMean::SPELL_CHECKERS[]=` 和 `DidYouMean::SPELL_CHECKERS.merge!` 已被移除。
216+
217+
* Net::HTTP
218+
219+
* 移除以下已廢棄的常數：
220+
* `Net::HTTP::ProxyMod`
221+
* `Net::NetPrivate::HTTPRequest`
222+
* `Net::HTTPInformationCode`
223+
* `Net::HTTPSuccessCode`
224+
* `Net::HTTPRedirectionCode`
225+
* `Net::HTTPRetriableCode`
226+
* `Net::HTTPClientErrorCode`
227+
* `Net::HTTPFatalErrorCode`
228+
* `Net::HTTPServerErrorCode`
229+
* `Net::HTTPResponseReceiver`
230+
* `Net::HTTPResponceReceiver`
231+
232+
這些常數在 2012 年被廢棄。
233+
234+
* Timeout
235+
236+
* Timeout.timeout 拒絕負數值。 [[Bug #20795]]
237+
238+
* URI
239+
240+
* 將預設解析器從 RFC 2396 標準改成 RFC 3986 標準。
241+
[[Bug #19266]]
242+
243+
## 更新的 C API
244+
245+
* `rb_newobj` 和 `rb_newobj_of` (和相對應的巨集 `RB_NEWOBJ`, `RB_NEWOBJ_OF`, `NEWOBJ`, `NEWOBJ_OF`) 已經被移除。 [[Feature #20265]]
246+
* 移除已廢棄的函式 `rb_gc_force_recycle`。 [[Feature #18290]]
247+
248+
## 其他變更
249+
250+
* 將 block 傳遞給不使用傳入 block 的方法，會在 verbose 模式 (`-w`) 下顯示警告。
251+
[[Feature #15554]]
252+
253+
* 當重新定義一些由直譯器與 JIT 特別最佳化的核心方法，例如 `String.freeze` 和 `Integer#+`，現在會發出效能類型警告 (`-W:performance` or `Warning[:performance] = true`)。
254+
[[Feature #20429]]
255+
256+
參見 [NEWS](https://docs.ruby-lang.org/en/3.4/NEWS_md.html)
257+
和 [commit logs](https://github.com/ruby/ruby/compare/v3_3_0...{{ release.tag }})
258+
來了解更多。
259+
260+
自 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)。
261+
262+
耶誕快樂、佳節愉快，享受與 Ruby 3.4 一起寫程式的時光！
263+
264+
## 下載
265+
266+
* <{{ release.url.gz }}>
267+
268+
SIZE: {{ release.size.gz }}
269+
SHA1: {{ release.sha1.gz }}
270+
SHA256: {{ release.sha256.gz }}
271+
SHA512: {{ release.sha512.gz }}
272+
273+
* <{{ release.url.xz }}>
274+
275+
SIZE: {{ release.size.xz }}
276+
SHA1: {{ release.sha1.xz }}
277+
SHA256: {{ release.sha256.xz }}
278+
SHA512: {{ release.sha512.xz }}
279+
280+
* <{{ release.url.zip }}>
281+
282+
SIZE: {{ release.size.zip }}
283+
SHA1: {{ release.sha1.zip }}
284+
SHA256: {{ release.sha256.zip }}
285+
SHA512: {{ release.sha512.zip }}
286+
287+
## Ruby 是什麼
288+
289+
Ruby 最初由 Matz（Yukihiro Matsumoto）於 1993 年開發的開源軟體。可以在許多平台上執行。使用者來自世界各地，特別活躍於網路開發領域。
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

‎zh_tw/news/_posts/2024-12-25-ruby-3-4-1-released.md

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: "Bear Su"
6+
date: 2024-12-25 00:00:00 +0000
7+
lang: zh_tw
8+
---
9+
10+
Ruby 3.4.1 已經發布了。
11+
12+
修復了版本描述。
13+
14+
詳細的變動請參閱 [GitHub 發布](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+
SIZE: {{ 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+
SIZE: {{ 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+
SIZE: {{ release.size.zip }}
37+
SHA1: {{ release.sha1.zip }}
38+
SHA256: {{ release.sha256.zip }}
39+
SHA512: {{ release.sha512.zip }}

0 commit comments

Comments
 (0)