Use `node -v` e `npm -v` para conferir se os dois comandos estão disponíveis no terminal.
Entre na pasta do projeto antes de executar qualquer comando de início.
Identifique o arquivo de entrada, que pode se chamar `index.js`, `server.js` ou `app.js`.
Execute `node` seguido do nome do arquivo de entrada para rodar o código.
Abra o endereço local configurado no projeto para testar a resposta do servidor.
Quem está começando a testar aplicações Node.js localmente costuma travar num ponto simples: o projeto existe, os arquivos estão na pasta certa, mas falta saber qual comando digitar no terminal para colocar o servidor no ar.
Este guia resolve exatamente essa etapa, sem exigir conhecimento avançado de programação.
O que verificar antes de iniciar o servidor
Antes de tentar rodar qualquer projeto, é recomendável confirmar que o ambiente está pronto. No terminal, os comandos node -v e npm -v mostram, respectivamente, a versão instalada do Node.js e a versão do npm, o gerenciador de pacotes que acompanha a instalação.
Teste vocacional
Qual carreira combina com o seu perfil?
Responda as perguntas e descubra o curso certo e as bolsas ideais para você!
Se esses comandos retornarem uma mensagem de erro em vez de um número de versão, o Node.js provavelmente não está instalado no computador.
Nesse caso, o download deve ser feito pelo site oficial do projeto, e não por pacotes de terceiros ou tutoriais que prometam atalhos.
Estrutura mínima do projeto e o arquivo package.json
Todo projeto Node.js organizado costuma ter um arquivo package.json, criado normalmente com o comando npm init -y.
Esse arquivo descreve o projeto: nome, versão, dependências instaladas e, quando configurado, os scripts de execução.
As bibliotecas instaladas via npm ficam guardadas na pasta node_modules, e é o package.json que registra quais delas o projeto usa.
O arquivo responsável por iniciar o servidor, porém, não tem nome fixo: pode ser index.js, server.js ou app.js, dependendo de como quem criou o projeto organizou os arquivos.
Antes de rodar qualquer comando, é importante abrir a pasta do projeto e identificar visualmente esse arquivo.
Comando para colocar o servidor no ar pelo terminal
Com o arquivo de entrada identificado, o próximo passo é abrir o terminal e navegar até a pasta do projeto usando o comando cd, seguido do caminho da pasta. Executar o comando de início em uma pasta errada é uma causa comum de erro nessa etapa.
Dentro da pasta correta, o servidor é iniciado com o comando node seguido do nome do arquivo de entrada, como em node index.js.
Se o arquivo do projeto tiver outro nome, o comando muda na mesma proporção: node server.js ou node app.js, por exemplo. O terminal deve permanecer aberto e sem mensagens de erro para indicar que o processo continua em execução.
Atalho com scripts definidos no package.json
Digitar o caminho do arquivo a cada execução funciona, mas projetos mais organizados costumam definir um script chamado start dentro do package.json.
Quando esse script existe, basta executar npm start no terminal, e o npm se encarrega de chamar o arquivo correto por trás dos panos
Outra ferramenta útil nessa fase é o nodemon, que reinicia o servidor automaticamente sempre que um arquivo do projeto é alterado. Isso evita o trabalho manual de parar o terminal com Ctrl+C e digitar o comando de início de novo a cada mudança no código.
Como confirmar que o servidor está rodando
Depois que o terminal mostra o processo em execução, sem erros, o passo seguinte é abrir o navegador e acessar o endereço local configurado no projeto.
Se o servidor responder com uma página, um texto ou uma mensagem definida no código, a execução foi bem-sucedida.
Em projetos que já usam o Express, framework comum para organizar rotas em aplicações Node.js, essa resposta costuma vir de uma rota definida explicitamente no código, como a rota principal do site.
Se o projeto não usa nenhum framework, a resposta pode ser mais simples, gerada diretamente pelo módulo nativo de servidor do Node.js.
Perguntas frequentes
Preciso instalar algo além do Node.js para rodar o servidor?
Na maioria dos casos, não. O npm já vem junto com a instalação do Node.js, e o comando npm -v confirma isso no terminal.
Se o projeto ainda não tiver um package.json, ele pode ser criado com npm init -y antes de instalar qualquer dependência adicional que o servidor exija.
Por que o comando node index.js não funciona no meu projeto?
As duas causas mais comuns são o nome do arquivo e a pasta de execução. Se o arquivo de entrada do projeto se chama server.js ou app.js, o comando precisa refletir esse nome. Da mesma forma, o terminal precisa estar posicionado dentro da pasta do projeto antes de executar o comando.
Como iniciar o servidor com npm start?
Esse atalho só funciona quando o package.json do projeto já tem um script chamado start apontando para o arquivo correto. Sem esse script configurado, o npm start retorna erro, e o comando node com o nome do arquivo continua sendo necessário.
Como sei em qual porta o servidor está rodando?
A porta usada pelo servidor é definida dentro do próprio arquivo de entrada, no trecho de código que inicia a escuta de conexões. Por isso, abrir esse arquivo e localizar esse trecho é a forma mais confiável de confirmar o número da porta antes de testar no navegador.
O que fazer quando a porta já está em uso?
Quando o terminal indica que a porta já está ocupada, geralmente outro processo Node.js ainda está em execução em segundo plano. Encerrar esse processo no terminal ou reiniciar o computador libera a porta; outra opção é alterar o número da porta no código do arquivo de entrada antes de tentar novamente.
Como evitar reiniciar o servidor manualmente a cada alteração no código?
A ferramenta nodemon foi criada justamente para isso: ela observa os arquivos do projeto e reinicia o servidor automaticamente sempre que detecta uma alteração salva, sem exigir que o terminal seja interrompido e o comando digitado de novo.
Construa sua carreira em tecnologia com formações alinhadas ao mercado
Se você quer ingressar ou crescer no mercado da tecnologia, a Allevo Tech oferece formações práticas em áreas de alta demanda, como Engenharia de Software, Ciência de Dados e Inteligência Artificial.
As trilhas são estruturadas para desenvolver competências técnicas e preparar você para os desafios do mercado de trabalho.
Clique no botão abaixo e conheça as formações da Allevo Tech que podem impulsionar a sua trajetória profissional.
Ver publicações 
