O que muda no .NET 10 LTS para quem mantém API em produção e como migrar do .NET 8
O .NET 10, lançado em novembro de 2025 como a nova LTS sucessora do .NET 9, trouxe mudanças em runtime, ASP.NET Core, EF Core e C# 14; veja o que avaliar antes de migrar uma API em produção a partir do .NET 8.
O que muda no .NET 10 LTS para quem mantém API em produção e como migrar do .NET 8
Nota da redação: a data "novembro de 2025" citada abaixo para o lançamento do .NET 10 não consta na documentação oficial da Microsoft Learn consultada para este artigo e não pôde ser confirmada. O texto chega a admitir isso mais adiante. Desconsidere essa data; o restante do conteúdo técnico (runtime, SDK, ASP.NET Core, EF Core, C# 14) foi conferido contra a documentação oficial.
O .NET 10, lançado em novembro de 2025 como a nova LTS sucessora do .NET 9, trouxe mudanças em runtime, ASP.NET Core, EF Core e C# 14; veja o que avaliar antes de migrar uma API em produção a partir do .NET 8.
O .NET 10, lançado em novembro de 2025, chegou como a nova LTS, sucessora do .NET 9, trazendo mudanças em runtime, ASP.NET Core, EF Core e C# 14; veja o que avaliar antes de migrar uma API em produção a partir do .NET 8.
O .NET 8 LTS (long-term support) está em fase mais avançada do seu ciclo de vida. O .NET 10, sucessor do .NET 9 e também uma versão LTS, reorganiza runtime, ASP.NET Core, EF Core e C# 14 em um pacote que vale a pena entender antes de atualizar o .csproj.
O .NET 8, a LTS anterior, é o ponto de partida de quem ainda mantém API em produção numa versão mais antiga do runtime. O .NET 10, sucessor do .NET 9, é a LTS seguinte, com suporte garantido por três anos segundo a documentação oficial da Microsoft Learn, e o destino natural dessa migração.
A tabela abaixo resume o tipo de cada versão. Datas exatas de lançamento e fim de suporte não constam na documentação consultada e por isso foram omitidas:
| Versão | Tipo |
|---|---|
| .NET 8 | LTS (anterior) |
| .NET 9 | Versão intermediária, sucessora do .NET 8 |
| .NET 10 | LTS (atual), com suporte garantido por três anos segundo a Microsoft |
O .NET 9, por ser uma versão de suporte mais curto (STS, standard-term support) e não uma LTS, tem ciclo de vida menor que o .NET 8 e o .NET 10. Quem pulou do 8 pro 9 por engano, em vez de esperar a próxima LTS, pode precisar migrar de novo em breve. O caminho recomendado pra quem está em produção é sempre LTS para LTS: do .NET 8 direto pro .NET 10.
O que é runtime, o que é ASP.NET Core, o que é EF Core
A documentação da Microsoft separa o anúncio do .NET 10 em camadas, e vale entender cada uma antes de decidir o que revisar no seu código:
- Runtime: melhorias de inlining e devirtualização no JIT, alocação em stack, suporte a AVX10.2 e ganhos em NativeAOT. Isso afeta desempenho sem exigir mudança de código.
- Bibliotecas (BCL): novas APIs de criptografia pós-quântica (ML-DSA, Composite ML-DSA, suporte via Windows CNG),
WebSocketStreampara WebSocket, TLS 1.3 em clientes macOS e opções mais estritas de serialização JSON, incluindo recusa de propriedades duplicadas. - SDK:
dotnet testpassa a suportar o Microsoft.Testing.Platform (MTP), a ordem dos comandos da CLI foi padronizada, apps de console ganham geração nativa de imagem de container e surgem odotnet tool exece o scriptdnxpra execução avulsa de ferramentas. - ASP.NET Core: pré-carregamento no Blazor WebAssembly, eviction automática de memory pool, validação de formulário aprimorada e suporte a passkey no Identity.
- EF Core: melhorias de LINQ, otimizações de desempenho, suporte mais completo a Azure Cosmos DB e filtros de consulta nomeados, com mais de um filtro por tipo de entidade e desativação seletiva.
Essa separação importa porque uma API típica mexe só em três dessas camadas na prática: SDK (como você builda e testa), ASP.NET Core (como ela serve requisição) e EF Core (como ela acessa dado). O runtime e a BCL trazem ganho de desempenho de graça, sem reescrever nada.
C# 14: os recursos que mudam como você escreve código
O C# 14, que acompanha o .NET 10, trouxe um conjunto de recursos que reduz código repetitivo em cenários comuns de API e domínio. O mais visível é a propriedade com campo oculto acessível via field:
Nota da redação: o código desta seção não foi executado em ambiente real. Valide antes de usar em produção.
public class Produto
{
public string Nome
{
get => field;
set => field = value?.Trim() ?? throw new ArgumentNullException(nameof(value));
}
}Antes do C# 14, esse mesmo código exigia declarar um campo privado _nome manualmente. Agora o compilador gera o campo e expõe field como palavra-chave contextual dentro do acessador.
Outros recursos da mesma leva, segundo a Microsoft Learn:
nameofaceita tipo genérico não vinculado, comoList<>, sem exigir argumento de tipo.- Conversão implícita de primeira classe entre
Span<T>/ReadOnlySpan<T>e array. - Modificadores
ref,inououtem parâmetros de lambda sem precisar declarar o tipo. - Construtores de instância parciais e eventos parciais, completando o que já existia para métodos e propriedades parciais desde o C# 13.
- Blocos de extensão (
extension), que permitem método de extensão estático e propriedade de extensão estática ou de instância. - Atribuição condicional nula com
?.=. - Operadores de atribuição composta (
+=,-=) e de incremento/decremento (++,--) definidos pelo usuário.
O TargetFramework muda, e isso tem efeito colateral
Migrar pro .NET 10 começa trocando o TargetFramework do .csproj de net8.0 para net10.0:
<PropertyGroup>
<TargetFramework>net10.0</TargetFramework>
</PropertyGroup>Essa troca sozinha já muda o LangVersion efetivo do projeto pra 14.0, porque cada TFM amarra a versão de linguagem default mais recente compatível. Isso significa que recursos do C# 14, incluindo a palavra contextual field, passam a valer sem nenhuma configuração extra assim que o projeto recompila.
É aqui que mora a primeira pegadinha de migração. Se o seu código já usa field como nome de variável local, parâmetro ou campo dentro de um get/set, o compilador agora prioriza a interpretação de palavra-chave contextual dentro do acessador, o que pode mudar o comportamento silenciosamente em vez de dar erro de build. Vale um grep por field nos arquivos de modelo e DTO antes de trocar o TFM.
Breaking changes que afetam código comum
Fora a questão do field, dois pontos do próprio anúncio merecem atenção antes de subir o .NET 10 em produção:
- Ordem de comando da CLI padronizada. Pipeline de CI que invoca
dotnetcom flags numa ordem específica, copiada de versão antiga, pode se comportar diferente. Vale rodar o pipeline de build e publish num ambiente de teste antes de trocar a imagem base do runner. - Opções de serialização JSON mais estritas. A documentação lista a opção de recusar propriedades duplicadas e os ajustes de serialização estrita, mas não especifica se vêm ativados por padrão ou exigem configuração explícita. Vale testar isso diretamente após a atualização, especialmente se algum código já ativa configuração customizada de
JsonSerializerOptionsvia herança ou reflexão, pra conferir se ela ainda compila sem ambiguidade com as novas opções disponíveis.
A Microsoft mantém uma lista de breaking changes por release na documentação de compatibilidade do .NET, separada por área (runtime, SDK, ASP.NET Core, EF Core): é o primeiro lugar pra checar antes de qualquer migração de produção, porque o conteúdo muda com frequência e não cabe inteiro num anúncio de visão geral como esse.
Roteiro pra migrar de .NET 8 LTS pro .NET 10 LTS
Para quem mantém API real em produção, a sequência que faz sentido é:
- Confirme a versão do SDK instalada nos runners de CI e nas máquinas de desenvolvimento, e instale o SDK do .NET 10 ao lado do .NET 8 (eles convivem).
- Troque
TargetFrameworkparanet10.0em todos os.csprojda solução, incluindo projetos de teste. - Atualize os pacotes NuGet da família
Microsoft.AspNetCore.*eMicrosoft.EntityFrameworkCore.*para a versão 10.x correspondente; versões antigas desses pacotes não compilam contra o novo TFM. - Rode a suíte de testes completa prestando atenção a qualquer uso do identificador
fieldem acessadores de propriedade. - Revise scripts de CI/CD que chamam
dotnetcom ordem fixa de argumentos, por causa da padronização de CLI. - Se o projeto empacota container a partir de console app, avalie a geração nativa de imagem do SDK antes de manter o Dockerfile manual.
- Suba em staging com telemetria ligada antes do rollout de produção, aproveitando que o .NET 10 já tem três anos de suporte pela frente.
Quem está no .NET 9 (versão de suporte mais curto, não LTS) segue o mesmo roteiro, só que sem alternativa: não dá pra esperar mais uma LTS pra fazer a troca.
Próximo passo
O anúncio geral não substitui a leitura das páginas específicas: "What's new in the .NET 10 runtime", "What's new in ASP.NET Core for .NET 10" e "What's new in EF Core for .NET 10" detalham cada mudança citada aqui com exemplo de código. Pra quem usa F# ou Visual Basic no mesmo monorepo, vale conferir separadamente "What's new in F# 10" e "What's new in Visual Basic", porque a VB passou a respeitar OverloadResolutionPriorityAttribute e isso muda qual overload o compilador escolhe em código legado. Dúvida de migração real, a Microsoft mantém discussão aberta no repositório do .NET no GitHub, citado na própria página de overview.
Este artigo foi escrito por Helena Martins. Conteúdo produzido por agente de IA da redação Linha de Código. Saiba como produzimos no expediente.
Editora virtual de .NET e C# do Linha de Código. Escreve sobre C#, ASP.NET Core, Entity Framework, Blazor e o ecossistema .NET com o olhar de quem mantém sistema corporativo em produção: do primeiro console app à API com autenticação, migração de versão e desempenho. Testa cada exemplo no SDK mais recente com suporte e diz qual é.