Instale o .NET, Visual Studio Code e crie seu primeiro aplicativo.
Pré-requisitos
500 MB de espaço disponível no disco rígido.
500 MB de espaço disponível no disco rígido.
macOS 12.0 ou versões posteriores.
Tempo para conclusão
Cinco minutos + tempo de download/instalação
Situação
Um aplicativo simples escrito em C# que imprime Hello, World! para o console.
Baixar e instalar
Para criar o seu primeiro aplicativo do .NET, você precisará instalar o SDK do .NET, o Visual Studio Code e o Kit de Desenvolvimento em C#.
O que são o SDK do .NET, o Visual Studio Code e o Kit de Desenvolvimento em C#?
O SDK (Software Development Kit) do .NET é uma coleção gratuita e de software livre de ferramentas e bibliotecas que você precisará para criar e executar aplicativos usando C#. C# é a linguagem de programação moderna orientada a objeto que você usará para este tutorial.
O Visual Studio Code (VS Code) é o editor de código leve, gratuito e de software livre mais popular do mundo. É aqui que você escreverá o seu código em C#.
O Kit de Desenvolvimento em C# é um conjunto avançado de extensões do VS Code que facilita o desenvolvimento em C#. Ele ajuda você a escrever, testar e depurar o seu código à medida que você cria aplicativos.
O arquivo de Configuração do WinGet do .NET instalará o SDK do .NET 10, o VS Code e o Kit de Desenvolvimento do C# para você. Se você já tiver uma parte instalada, o WinGet irá ignorar essa etapa de instalação.
Para criar seu primeiro aplicativo .NET com o Visual Studio Code, configure seu ambiente:
Abra o VS Code e selecione o botão Extensões na Barra de Atividades do VS Code à esquerda. Digite C# na barra de pesquisa, selecione o Kit de Desenvolvimento C# e selecione o botão Instalar na página da extensão Kit de Desenvolvimento em C#.
Baixe e execute o arquivo de configuração
Clique no link a seguir para baixar o arquivo do WinGet:
Abra a sua pasta de downloads e clique duas vezes no arquivo para iniciar a instalação. Se for solicitado que você selecione um aplicativo para executar o arquivo, selecione Cliente do Gerenciador de Pacotes do Windows.
Um terminal será aberto e você verá que o arquivo de Configuração do WinGet está pronto para instalar o SDK do .NET 10, VS Code se você não o tiver e o Kit de Desenvolvimento C#.
Leia o contrato de licença e concorde com ele digitando "y" no terminal e pressionando Enter.
Observação: você é responsável por entender as definições de configuração que está optando por executar. A Microsoft não é responsável pelo arquivo de configuração que você criou ou importou. Essa configuração talvez possa alterar as definições no Windows, instalar software, alterar configurações de software (incluindo configurações de segurança) e aceitar contratos de usuário para pacotes e serviços de terceiros em seu nome. Ao executar esse arquivo de configuração, você reconhece que entende e concorda com esses recursos e definições. Todos os aplicativos instalados são licenciados para você pelos respectivos proprietários. A Microsoft não é responsável nem concede licenças para pacotes ou serviços de terceiros.
Agora, o Winget está instalando tudo o que você precisa para começar! O tempo de instalação vai depender das especificações da sua máquina, velocidade da rede e de outros fatores. Pode levar apenas 5 minutos, mas pode demorar até 15 minutos para ser concluído.
Algumas etapas de instalação podem exigir permissões de nível de administrador. Fique atento aos prompts piscando no Controle de Conta de Usuário (UAC) na sua Barra de Tarefas do Windows e clique nesse ícone. Para continuar a instalação, selecione Sim se solicitado.
Quando a instalação for concluída, você deverá ver a saída abaixo no terminal.
Verifique se tudo foi instalado corretamente
Agora que o seu ambiente está configurado, vá para Arquivar na Barra de Tarefas do Windows e digite Visual Studio Code. Clique no aplicativo para abrir o VS Code.
Depois de configurar seu ambiente, abra um novo terminal do VS Code. Na barra de ferramentas, selecione Terminal, depois Novo Terminal.
Observação: se você abrir o VS Code usando um terminal, precisará habilitar a Confiança do Workspace.
Agora, abra um novo terminal acessando a barra de ferramentas e selecionando Terminal e Novo Terminal.
No terminal, execute o comando a seguir para verificar sua instalação.
Terminal
dotnet
Se a instalação for bem-sucedida, você deverá ver uma saída semelhante à seguinte:
Terminal
Usage: dotnet [path-to-application]Usage: dotnet [commands]path-to-application:The path to an application .dll file to execute.commands:-h|--help Display help.--info Display .NET information.--list-runtimes [--arch ] Display the installed runtimes matching the host or specified architecture. Example architectures: arm64, x64, x86.--list-sdks [--arch ] Display the installed SDKs matching the host or specified architecture. Example architectures: arm64, x64, x86.
Se tudo estiver certo, selecione o botão Continuar abaixo para ir para a próxima etapa.
Encontrou um erro?
Se você receber um erro o "dotnet" não é reconhecido como um comando interno ou externo, verifique se você abriu um novo terminal do VS Code. Se a reinicialização do VS Code ou a reinicialização do computador não resolver o problema, use o botão Encontrei um problema para obter ajuda para corrigir o problema.
Criar seu aplicativo
Abra a paleta de comandos no VS Code pressionando CTRL+SHIFT+P.
Abra a paleta de comandos no VS Code pressionando CMD+SHIFT+P.
Digite .NET: para ver os comandos que você pode executar com o Kit de Desenvolvimento em C#!
Localize e selecione .NET: Novo Projeto para criar um novo projeto .NET.
Role para baixo e selecione Aplicativo do Console.
Escolha o local da pasta em que você quer salvar seu projeto.
Nomeie o projeto MyConsoleApp na paleta de comandos quando solicitado.
Se solicitado, habilite Confiança do Workspace marcando a caixa e selecionando Sim, eu confio nos autores.
Observação: embora entrar não seja necessário nem exigido pela extensão, talvez você precise entrar com sua conta do Visual Studio para cumprir os requisitos do EULA da extensão do Kit de Desenvolvimento C#.
Na Barra Lateral do VS Code, verifique se o Explorer está aberto. Clique na pasta MyConsoleApp para se certificar de que esteja expandida.
O arquivo principal na pasta MyConsoleApp é chamado de Program.cs. Por padrão, ele já contém o código necessário para gravar Hello, World! no terminal. Clique no arquivo para ver o código criado pelo modelo:
Selecione o botão Continuar abaixo para ir para a próxima etapa.
Encontrou um erro?
Se o problema não for resolvido, selecione o botão Ocorreu um problema abaixo para obter ajuda para corrigir o problema.
Executar seu aplicativo
Para executar seu aplicativo, selecione o menu suspenso à direita do botão executar no canto superior direito e selecione Executar o projeto associado a este arquivo.
Você deve ver Hello, World! em seu terminal do VS Code.
Terminal
Hello, World!
Parabéns, você criou e executou seu primeiro aplicativo .NET! Selecione o botão Continuar abaixo para ir para a próxima etapa.
Editar seu código
No arquivo Program.cs, adicione a linha realçada após o código que imprime Hello, World!, da seguinte maneira:
Program.cs
// See https://aka.ms/new-console-template for more informationConsole.WriteLine("Hello, World!");Console.WriteLine("The current time is " + DateTime.Now);
Salve o arquivo Program.cs e selecione Executar o projeto associado ao arquivo novamente. Se você tiver sucesso, deverá ver uma saída semelhante à seguinte:
Terminal
Hello, World!
The current time is 11/09/2026 10:13:07
Próximas etapas
Parabéns, você criou e executou seu primeiro aplicativo .NET!
Continuar aprendendo
Para continuar aprendendo as habilidades gerais do .NET, experimente nossos tutoriais no Microsoft Learn onde você aprenderá sobre o .NET, dependências, trabalhar com arquivos, depuração e muito mais:
C# é a linguagem de programação moderna, inovadora e de código aberto do .NET para compilar todos os seus aplicativos. Introdução ao testar nossos tutoriais do C# interativo no Microsoft Learn:
