Microsoft C++ （MSVC） 編譯器版本設定

Microsoft C++ （MSVC） 編譯器版本包含四個欄位：

• M：主版本（兩位數）
• N：小調版本（兩位數）
• B：建置版本（五位數）
• R：修訂版

Microsoft特定編譯程式巨集編碼這些字段，如下所示：

• _MSC_VER = MMNN
• _MSC_FULL_VER = MMNNBBBBB
• _MSC_BUILD = R

例如，Visual Studio 2022 17.9.0 版的編譯程式版本是 19.39.33519：

• 主要版本為 19
• 次要版本為 39
• 組建版本為 33519
• 修訂版本為 0

巨集會反映這些值，如下所示：

• _MSC_VER = 1939
• _MSC_FULL_VER = 193933519
• _MSC_BUILD （修訂版）為 0

Visual Studio 通道

所有 MSVC 建置工具皆可透過 Visual Studio 安裝程式取得。

Visual Studio 穩定通道每月更新，並包含最新支援的 MSVC 建置工具。 Visual Studio Insiders Channel 更新更頻繁，讓你能更早嘗試即將到來的 MSVC 變更。 如需更多關於發行節奏的詳細資訊，請參閱 Visual Studio 2026 發行節奏 和 Visual Studio Insiders 發行說明。

每次 Visual Studio 更新都會接收所有 MSVC 建置工具組的更新：

• 預覽工具組新增了開發團隊自上次更新以來完成的新功能與修正。
• 預設及較舊的支援工具組只會獲得針對性的錯誤修正。

Visual Studio Insiders 使用者可提前取得 MSVC 版本：

• 在 Insiders 頻道上，預覽工具組大約每週更新一次。
• 在 Insiders Channel，新工具集會在進入穩定頻道前約一個月作為候選版本釋出，讓 Insiders 用戶有時間驗證工具組並回報問題。

安裝特定的 MSVC 工具組

• 若要只安裝預設的 MSVC 工具組，請安裝 Desktop development with C++ 工作負載。
• 要安裝預覽工具組，請執行 Visual Studio 安裝程式，選擇 MSVC 建置工具 for <arch> （Preview）。 欲了解更多資訊，請參閱 MSVC 建置工具預覽。
• 若要安裝較舊的支援中的 14.5x 工具組，請執行 Visual Studio 安裝程式，開啟 Individual Components 標籤，選擇特定的 14.5x 工具組。
• 若要在升級後還原先前安裝的工具組——例如當 14.50 被 14.51 取代時—— 請從「個別元件 」標籤中將舊工具組重新加入。
• 若要只安裝建置工具而不安裝完整Visual Studio IDE，請使用 Visual Studio 穩定建置工具 SKU。
• 部分已不支援的工具組（標示為 （Out of support））也可能在 Visual Studio 安裝程式中提供。 這些工具組不會有任何更新，未來可能會被移除。 我們強烈建議你升級到支援的版本。

版本巨集

回想一下，版本號碼包含四個字段：

• M：主版本（兩位數）
• N：小調版本（兩位數）
• B：建置版本（五位數）
• R：修訂版

_MSC_VER 區分主要和次要版本。 其格式為：MMNN。

_MSC_FULL_VER 表示編譯程式的主要、次要和組建版本。 其格式為：MMNNBBBBB。 使用它來區分編譯程式的不同版本，包括維護版本。 如需 Visual Studio 2019 16.8、16.9、16.10 和 16.11 版的詳細資訊，請參閱從 Visual Studio 2017 開始的服務版本。

_MSC_BUILD 代表編譯器的修訂版本。 它的形式為：R。用它來區分編譯器版本。

當主要版本在 Visual Studio 2013 與 Visual Studio 2015 之間變更時，_MSC_VER 會反映此變更，從 1800 變為 1900。

次要變更的範例是從 Visual Studio 2022 17.1 版變更至 Visual Studio 2022 17.2 版。 在此情況下， _MSC_VER 從 1931 年變更為 1932 年。

下表列出對應每個 MSVC 編譯器（_MSC_VER）及 MSVC 建置工具版本的Visual Studio版本，以及支援狀態。 EOL代表生命終結。

下表列出 Visual Studio 2026 及更新版本的 MSVC 建置工具版本。 從 Visual Studio 2026 開始，MSVC 版本管理與 Visual Studio 版本管理是分離的。 終止生命週期（EOL）日期由 MSVC 生命週期政策定義。

^a Visual Studio 2019 版本 16.8 與 16.9 共享相同的主版本與次要版本，因此 _MSC_VER 值相同。 若要區分它們，請使用 _MSC_FULL_VER。 Visual Studio 2019 16.8 版的最小 _MSC_FULL_VER 值為 192829333。 Visual Studio 2019 16.9 版的最小 _MSC_FULL_VER 值為 192829910。

^b Visual Studio 2019 版本 16.10 與 16.11 共享相同的主版本與次要版本，因此 _MSC_VER 的值相同。 若要區分它們，請使用 _MSC_FULL_VER。 Visual Studio 2019 16.10 版的最小 _MSC_FULL_VER 值為 192929917。 Visual Studio 2019 16.11 版的最小 _MSC_FULL_VER 值為 192930129。

^c MSVC 建置工具版本 14.52 目前處於預覽階段。 EOL 日期將於正式發布時確定。

Microsoft C++ 編譯器版本設定的簡史

Visual Studio 6.0 到 Visual Studio 2015 （14.0）

• 對於主要版本，_MSC_VER 會增加 100。 _MSC_FULL_VER 增加了 10,000,000。

• 對於次要版本，_MSC_VER 會增加 10。 _MSC_FULL_VER 增加 1,000,000。

  Note

  Visual Studio .NET 2003 被視為次要版本。

Visual Studio 2017 至 Visual Studio 2022

• 針對主要版本，次要版本會增加 10。
• 針對次要版本，次要版本從 Visual Studio 2017 15.3 版開始增加 1。

Visual Studio 2026 和更新版本

隨附於 Visual Studio 2026 及後續版本的 MSVC 建置工具，其版本從 14.50 開始，而 _MSC_VER 則從 1950 開始。 新的MSVC版本——14.51/1951、14.52/1952，依此類推，每六個月出貨一次。 支援遵循 MSVC 生命週期政策。

此版本管理系統與早期 Visual Studio 版本不同，因為 MSVC 版本管理現已與 Visual Studio 版本管理分開。 這表示編譯器的次要版本可以在多次 Visual Studio 更新中保持不變。

Visual Studio 安裝程式隨時可提供多個 MSVC 版本：

• 包含最新變更的預覽工具組
• 目前預設工具組
• 仍在支援中的早期工具組

例如，截至2026年5月：

• 14.52 是預覽工具組，定期更新功能和修正。
• 14.51 是 2026 年 5 月發布的預設工具組，支援期為 9 個月。
• 14.50 是 2025 年 11 月發行的工具組，支援期為 3 年。

預計到 2026 年 11 月， 14.53 將成為新的預覽工具組， 14.52 將成為預設工具組，而 14.51 與 14.50 則將依照 MSVC 生命週期政策維持支援。

Microsoft 改變此模式有三個原因：

• 它將 MSVC 功能開發與預覽版開放的時間從數月縮短到約一週左右。
• 它讓 MSVC 的發佈節奏與 Visual Studio 保持一致，長期服務版本則與 .NET 長期支援（LTS）版本保持一致。
• 它降低了服務舊編譯器的複雜度。

自 Visual Studio 2017 起的服務版本

使用 _MSC_FULL_VER 來區分維護版本。 建置欄位（版本號碼 MMNNBBBBB 中的 BBBBB）通常會增加 1。

例如，_MSC_FULL_VER 有助於區分 2019 Visual Studio版本 16.8 與 16.9，以及Visual Studio 2019 版本 16.10 與 16.11。 這些版本共享相同的主版本與次要版本，因此對 _MSC_VER的值相同。

若要區分這些版本，請使用 _MSC_FULL_VER。
Visual Studio 2019 16.8 版的最小 _MSC_FULL_VER 值為 192829333。
Visual Studio 2019 16.9 版的最小 _MSC_FULL_VER 值為 192829910。

另請參閱

• 安裝 Microsoft C++（MSVC）建置工具
• _MSC_VER
• Visual C++ 編譯程式版本部落格文章