Controle de versão do compilador do Microsoft C++ (MSVC)

A versão do compilador do Microsoft C++ (MSVC) consiste em quatro campos:

• M: versão principal (dois dígitos)
• N: versão secundária (dois dígitos)
• B: versão de build (cinco dígitos)
• R: versão de revisão

As macros do compilador específicas da Microsoft codificam esses campos da seguinte maneira:

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

Por exemplo, a versão do compilador para o Visual Studio 2022 versão 17.9.0 é 19.39.33519:

• A a versão principal é a 19
• A versão secundária é a 39
• A versão de build é 33519
• A versão da revisão é 0

As macros refletem esses valores da seguinte forma:

• _MSC_VER = 1939
• _MSC_FULL_VER = 193933519
• _MSC_BUILD (a revisão) é 0

canais de Visual Studio

Todas as Ferramentas de Build do MSVC estão disponíveis por meio do Instalador do Visual Studio.

O Canal Estável do Visual Studio recebe atualizações mensais e inclui as ferramentas de compilação do MSVC com suporte mais recentes. O Visual Studio Insiders Channel é atualizado com mais frequência, para que você possa experimentar as próximas alterações do MSVC mais cedo. Para obter mais informações sobre a cadência de lançamento, consulte Visual Studio 2026 release rhythm and Visual Studio Insiders release notes.

Cada atualização do Visual Studio inclui atualizações para todos os conjuntos de ferramentas de compilação do MSVC:

• O conjunto de ferramentas de visualização recebe novos recursos e correções que a equipe de desenvolvimento concluiu desde a atualização anterior.
• Os conjuntos de ferramentas padrão e mais antigos em suporte recebem apenas correções de bug direcionadas.

Usuários do Visual Studio Insiders têm acesso antecipado aos lançamentos do MSVC:

• No canal Insiders, as ferramentas em prévia são atualizadas cerca de uma vez por semana.
• No canal Insiders, novos conjuntos de ferramentas ficam disponíveis como candidatas a lançamento cerca de um mês antes de chegarem ao Canal Estável, dando aos usuários do Insiders tempo para validar o conjunto de ferramentas e relatar problemas.

Instalar conjuntos de ferramentas específicos do MSVC

• Para instalar apenas o conjunto de ferramentas padrão do MSVC, instale o workload Desktop development with C++.
• Para instalar o conjunto de ferramentas de visualização, execute o instalador de Visual Studio e selecione MSVC Build Tools for <arch> (versão prévia). Para obter mais informações, consulte a versão prévia das Ferramentas de Build do MSVC.
• Para instalar um conjunto de ferramentas 14.5x com suporte mais antigo, execute o instalador de Visual Studio, abra a guia Componentes Individuais e selecione o conjunto de ferramentas 14,5x específico.
• Para restaurar um conjunto de ferramentas instalado anteriormente após uma atualização, por exemplo, quando 14.50 for substituído pela 14.51, adicione o conjunto de ferramentas mais antigo de volta da guia Componentes Individuais .
• Para instalar apenas as Ferramentas de Compilação sem o IDE completo do Visual Studio, use o Visual Studio Stable Build Tools SKU.
• Alguns conjuntos de ferramentas sem suporte (rotulados (sem suporte)) também podem estar disponíveis no Instalador Visual Studio. Esses conjuntos de ferramentas não recebem atualizações e podem ser removidos no futuro. É altamente recomendável migrar para uma versão com suporte.

Macros de versão

Lembre-se de que o número da versão consiste em quatro campos:

• M: versão principal (dois dígitos)
• N: versão secundária (dois dígitos)
• B: versão de build (cinco dígitos)
• R: versão de revisão

_MSC_VER distingue entre as versões principais e as secundárias. Ela tem o formato: MMNN.

_MSC_FULL_VER representa a versão principal, secundária e de build do compilador. Ela tem o seguinte formato: MMNNBBBBB. Use-o para distinguir entre diferentes versões do compilador, incluindo versões de manutenção. Para obter mais informações sobre o Visual Studio 2019 versões 16.8, 16.9, 16.10 e 16.11, consulte as versões do Serviço começando com o Visual Studio 2017.

_MSC_BUILD representa a versão de revisão do compilador. Ele tem o formulário: R. Use-o para distinguir entre revisões do compilador.

Quando a versão principal foi alterada entre Visual Studio 2013 e Visual Studio 2015, _MSC_VER reflete a alteração passando de 1800 para 1900.

Um exemplo de alteração secundária é do Visual Studio 2022 versão 17.1 para o Visual Studio 2022 versão 17.2. Nesse caso, _MSC_VER mudou de 1931 para 1932.

A tabela a seguir lista a versão Visual Studio que corresponde a cada compilador MSVC (_MSC_VER) e à versão do MSVC Build Tools, juntamente com o status de suporte. EOL significa fim da vida útil.

A tabela a seguir lista as versões do MSVC Build Tools para Visual Studio 2026 e posteriores. A partir do Visual Studio 2026, o controle de versão do MSVC é dissociado do controle de versão Visual Studio. As datas de EOL (fim da vida útil) são definidas pela política de ciclo de vida do MSVC.

as versões ^a Visual Studio 2019 16.8 e 16.9 compartilham as mesmas versões principais e secundárias e, portanto, têm o mesmo valor para _MSC_VER. Para distingui-los, use _MSC_FULL_VER. O valor mínimo do _MSC_FULL_VER Visual Studio 2019 versão 16.8 é 192829333. O valor mínimo do _MSC_FULL_VER Visual Studio 2019 versão 16.9 é 192829910.

as versões ^b Visual Studio 2019 16.10 e 16.11 compartilham as mesmas versões principais e secundárias e, portanto, têm o mesmo valor para _MSC_VER. Para distingui-los, use _MSC_FULL_VER. O valor mínimo do _MSC_FULL_VER Visual Studio 2019 versão 16.10 é 192929917. O valor mínimo do _MSC_FULL_VER Visual Studio 2019 versão 16.11 é 192930129.

^c As Ferramentas de Build do MSVC versão 14.52 estão em versão prévia. A data de EOL será definida quando houver disponibilidade geral.

Um breve histórico do controle de versão do compilador do Microsoft C++

Visual Studio 6.0 até o Visual Studio 2015 (14.0)

• Para as versões principais, _MSC_VER aumenta em 100. _MSC_FULL_VER aumenta em 10.000.000.

• Para as versões secundárias, _MSC_VER aumenta em 10. _MSC_FULL_VER aumenta em 1.000.000.

  Note

  O Visual Studio .NET 2003 foi considerado uma versão secundária.

Visual Studio 2017 para Visual Studio 2022

• Para versões principais, a versão secundária aumenta em 10.
• Para versões secundárias, a versão secundária aumenta em 1 a partir do Visual Studio 2017 versão 15.3.

Visual Studio 2026 e posterior

As ferramentas de build do MSVC incluídas no Visual Studio 2026 e versões posteriores começam a partir da versão 14.50, e _MSC_VER começa em 1950. Uma nova versão do MSVC — 14.51/1951, 14.52/1952 e assim por diante, é fornecida a cada seis meses. O suporte segue a política de ciclo de vida do MSVC.

Esse sistema de controle de versão difere das versões de Visual Studio anteriores porque o controle de versão do MSVC agora está separado do controle de versão Visual Studio. Isso significa que a versão secundária do compilador pode permanecer a mesma em várias atualizações Visual Studio.

A qualquer momento, o instalador de Visual Studio pode oferecer várias versões do MSVC:

• Um conjunto de ferramentas de visualização com as alterações mais recentes
• O conjunto de ferramentas padrão atual
• Conjuntos de ferramentas anteriores que ainda têm suporte

Por exemplo, a partir de maio de 2026:

• 14.52 é o conjunto de ferramentas de visualização e obtém atualizações regulares de recursos e correções.
• 14.51 é o conjunto de ferramentas padrão lançado em maio de 2026, com 9 meses de suporte.
• 14.50 é o conjunto de ferramentas lançado em novembro de 2025, com três anos de suporte.

Até novembro de 2026, esperamos que a 14.53 se torne o novo conjunto de ferramentas de visualização, 14.52 para se tornar o conjunto de ferramentas padrão e 14.51 e 14.50 para permanecer em suporte na política de ciclo de vida do MSVC.

A Microsoft mudou para esse modelo por três motivos:

• Reduz o tempo entre o desenvolvimento de funcionalidades do MSVC e a disponibilidade em versão prévia de meses para cerca de uma semana.
• Ela mantém a cadência de lançamentos do MSVC alinhada com o Visual Studio e os lançamentos com manutenção de longo prazo alinhados com as versões .NET de Suporte de Longo Prazo (LTS).
• Reduz a complexidade de manutenção de compiladores mais antigos.

Versões de serviço começando com o Visual Studio 2017

Use _MSC_FULL_VER para distinguir releases de manutenção. O campo de build (o BBBBB no número da versão MMNNBBBBB) normalmente aumenta em 1.

Por exemplo, _MSC_FULL_VER é útil para distinguir Visual Studio versão 16.8 2019 da 16.9 e Visual Studio versão 16.10 2019 da 16.11. Essas versões compartilham as mesmas versões principais e secundárias, portanto, elas têm o mesmo valor para _MSC_VER.

Para distinguir essas versões, use _MSC_FULL_VER.
O valor mínimo do _MSC_FULL_VER Visual Studio 2019 versão 16.8 é 192829333.
O valor mínimo do _MSC_FULL_VER Visual Studio 2019 versão 16.9 é 192829910.

Consulte também

• _MSC_VER
• Postagem no blog da versão do compilador do Visual C++