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 9, o VS Code e o Kit de Desenvolvimento em 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 Kit de Desenvolvimento em C# e, em seguida, selecione o botão Instalar na página de extensão do Kit de Desenvolvimento C#.
Baixar e executar o arquivo de configuração
Clique no link a seguir para baixar o arquivo WinGet:
Abra a pasta downloads e clique duas vezes no arquivo para iniciar a instalação. Se você for solicitado a selecionar um aplicativo para executar o arquivo, selecione Gerenciador de Pacotes do Windows Cliente.
Um terminal será aberto e você deverá verá que o arquivo de Configuração do WinGet está pronto para instalar o SDK do .NET 9, o VS Code se você não o tiver e o Kit de Desenvolvimento em 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.
O WinGet está instalando tudo o que você precisa para começar! O tempo de instalação dependerá das especificações do computador, da velocidade da rede e muito mais. Pode levar até 5 minutos, mas até 15 minutos para ser concluído.
Algumas etapas de instalação podem exigir permissões no nível do administrador para serem instaladas. Esteja em busca de prompts de UAC (Controle de Conta de Usuário) em seu barra de tarefas do Windows e clique nesse ícone. Para continuar a instalação, você deve selecionar 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 e, em seguida, Novo Terminal.
Observação: se você abrir VS Code por meio de um terminal, será necessário habilitar o de 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 [options]Usage: dotnet [path-to-application]Options:-h|--help Display help.--info Display .NET information.--list-sdks Display the installed SDKs.--list-runtimes Display the installed runtimes.path-to-application:The path to an application .dll file to execute.
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 de Console.
Escolha o local da pasta em que você deseja 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 a entrada não seja necessária ou imposta pela extensão, talvez seja necessário entrar usando sua conta do Visual Studio para cumprir os requisitos de EULA para a 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 projeto associado a esse 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 projeto associado ao arquivo novamente. Se você tiver sucesso, deverá ver uma saída semelhante à seguinte:
Terminal
Hello, World!
The current time is 03/07/2025 12:39:13
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:
