Zig 0.17 重定義 @bitCast，extern 型別轉型被禁
Zig 0.17.0 Release Notes · release notes 頁面未標示發布日期
@bitCast 不再依賴目標平台的位元組順序，而是改成對「邏輯位元表示」做重新詮釋，取代了舊版在不同 endian 上行為不一致的定義。這是 0.17.0 最容易讓既有程式悄悄壞掉的改動。
release notes 提到這個版本涵蓋 5 個月的工作、206 位貢獻者、925 個 commit。另一個值得專案維護者注意的是 build system 拆成 configurer 與 maker 兩個行程。
原本的問題
舊版 @bitCast 的語意在大端與小端目標上並不一致，同一段程式換個 target 可能得到不同結果。release notes 說明新定義「fully align with the old behavior on little-endian targets」，也就是小端平台的行為基本不變，差異主要落在其他平台。
build system 的問題在另一側：build.zig 的邏輯與 build graph 的執行放在同一個行程，所以只要改了 build.zig，整個 runner 都得重新編譯。
核心改動
@bitCast 的新定義是 reinterpret 值的 logical bit representation，支援整數、浮點、enum、packed struct／union，以及這些型別組成的陣列或向量。此行為與目標 endian 無關。
代價是涉及 extern struct 或 extern union 的轉型不再允許（#35966）。release notes 自己警告：這項改動有機會在沒有編譯錯誤的情況下弄壞既有程式。建議改用 @ptrCast 或 extern union，對照如下：
| 寫法 | |
|---|---|
| 舊 | const int: u16 = @bitCast(bytes);（bytes 為 extern struct） |
| 新 | const int_ptr: *align(1) const u16 = @ptrCast(&bytes); 再取 int_ptr.* |
build system 拆分（#35428）把流程分成兩部分：
- configurer：執行
build.zig邏輯並管理 package 相依。 - maker：以最佳化模式執行 build graph；編輯
build.zig時 maker 不變，只需建置一次。 - 依 CLI 參數不同，部分 build 邏輯可以略過。
notes 中記錄 cache hit 情境下有 5–10% 的加速（#36832）。設定以 --print-configuration 序列化成二進位格式。
影響範圍
對在 extern struct 上用 @bitCast 做 type punning 的程式影響最大，例如解析網路封包、檔案標頭或與 C ABI 互通的欄位。因為沒有編譯錯誤保證，升級後要自行搜尋所有 @bitCast 並確認操作對象型別。
另外，自訂 build runner 的專案要注意：release notes 指出「覆寫 build runner」的能力不再支援，這類需求改由 Build Server Protocol 處理。
枚舉轉換也有變動：@intFromEnum 與 @enumFromInt 被標為棄用，改為 @backingInt 與 @fromBackingInt。notes 的範例將 @enumFromInt(n) 改寫成 @fromBackingInt(@intCast(n))，細節請對照原文逐項處理。