檢視原始碼 相容性和棄用

Elixir 版本依據 vMAJOR.MINOR.PATCH 架構。

Elixir 目前為主要版本 v1。每 6 個月會推出一個向後相容的小版本。修補版本沒有排程，會在有錯誤修正或安全性修補時推出。

Elixir 僅對最新小版本套用錯誤修正。安全性修補適用於最後 5 個小版本

新版本會在唯讀的 公告郵件清單 中公告。所有安全性版本 都會標記為 [security]。

目前沒有主要 v2 版本的計畫。

非主要 Elixir 版本之間

Elixir 小版本和修補版本向後相容：在特定版本中定義良好的行為和文件化 API 會持續在未來版本中運作。

雖然我們預期絕大多數程式會持續相容，但無法保證未來變更不會中斷任何程式。在一些不太可能的情況下，我們可能會引入中斷現有程式碼的變更

• 安全性：實作中可能會出現安全性問題，而解決方案需要向後不相容的變更。我們保留處理此類安全性問題的權利。

• 錯誤：如果 API 有不想要的行為，依賴錯誤行為的程式可能會在錯誤修正後中斷。我們保留修正此類錯誤的權利。

• 編譯器前端：可能會對編譯器進行改善，為模稜兩可的模式引入新的警告，並提供更詳細的錯誤訊息。這些可能會導致編譯錯誤（在使用 --warning-as-errors 執行時），或在特定錯誤訊息上斷言時導致工具失敗（雖然應該避免這樣做）。我們保留進行此類改善的權利。

• 匯入：可能會將新的函式新增至 Kernel 模組，此模組會自動匯入。它們可能會與模組中定義的區域函式發生衝突。衝突可以使用 import Kernel, except: [...] 以向後相容的方式解決，其中清單列出所有不想從 Kernel 匯入的函式。我們保留進行此類新增的權利。

為了持續進化語言而不引入破壞性變更，Elixir 將依賴於棄用來降級某些實務並推廣新的實務。我們的棄用政策在 「棄用」區塊 中概述。

上述相容性保證的唯一例外是實驗性功能，這些功能會明確標示為實驗性功能，且在穩定之前不提供任何相容性保證。

Elixir 和 Erlang/OTP 之間

Erlang/OTP 版本控管獨立於 Elixir 的版本控管。Erlang 每年發布一個新的主要版本。我們的目標是在 Elixir 發布時支援最後三個 Erlang 主要版本。相容性表格如下所示。

Elixir 可以在修補程式版本中新增與新 Erlang/OTP 版本的相容性，例如在 v1.4.5 中支援 Erlang/OTP 20。這些版本是為了方便而製作，且通常包含 Elixir 在沒有錯誤的情況下執行的最小變更（如果需要變更的話）。只有下一個次要版本（在本例中為 v1.5.0）才能有效利用最新 Erlang/OTP 版本提供的全新功能。

棄用

政策

Elixir 棄用分為 3 個步驟

1. 功能已軟棄用。這表示 CHANGELOG 和文件都必須將該功能列為已棄用，但執行程式碼時不會實際發出警告。沒有軟棄用功能的要求。

2. 透過在使用時發出警告，該功能已實際棄用。這也稱為硬棄用。為了棄用某個功能，建議的替代方案必須存在於至少三個次要版本中。例如，Enum.uniq/2 在 Elixir v1.1 中已軟棄用，並建議使用 Enum.uniq_by/2。這表示只有 Elixir v1.4 或更新版本才會發出棄用警告。

3. 該功能已移除。這只能在主要版本中發生。這表示 Elixir v1.x 中的已棄用功能只能由 Elixir v2.x 移除。

棄用表格

第一欄是該功能已硬棄用的版本。第二欄簡短描述已棄用的功能，第三欄說明替換方案，以及替換方案可用的版本。