Como instalar Node.js no Windows

JavaScript executa a maior parte dos elementos interativos em sites e aplicativos móveis. JavaScript funciona perfeitamente com HTML/CSS e está integrado nos navegadores mais populares. O JavaScript puro é usado na web e, para aplicações gerais em JavaScript, os desenvolvedores utilizam diversos ambientes de execução, como o Node.js.

Node.js é um ambiente de execução para código JavaScript. Ele permite usar JavaScript como uma linguagem de programação de uso geral, criar componentes do lado do servidor e desenvolver aplicações desktop completas.

A base do Node.js é o motor V8. Esse motor foi desenvolvido pelo Google e é usado no navegador Google Chrome. Ele compila código JavaScript em código de máquina que o processador consegue interpretar. No entanto, para transformar JavaScript em uma linguagem de uso geral, apenas um motor não é suficiente. Por exemplo, para criar uma parte de servidor, a linguagem precisa conseguir trabalhar com arquivos, rede, etc. Para resolver isso, os desenvolvedores adicionaram recursos extras ao V8 usando seu próprio código e bibliotecas de terceiros. O resultado foi uma ferramenta que transforma o JavaScript em uma linguagem de propósito geral.

Node.js tornou-se popular entre desenvolvedores devido à sua capacidade de criar partes de servidor e cliente na mesma linguagem, sua velocidade e o NPM. Neste artigo, mostramos como instalar corretamente o Node.js no Windows 10/11.

Remover versões antigas

Antes da instalação, você deve desinstalar versões antigas do ambiente de execução, caso existam, pois podem causar conflitos.

Vamos verificar se existem versões do Node.js instaladas no sistema. Para isso, abra o cmd (pressione Win+R, digite cmd e aperte Enter) e execute o comando nvm list:

C:\Users\Hostman>nvm list
     18.9.0
     18.8.0
     16.17.0

Como pode ver, há várias versões instaladas. Para removê-las:

1. Execute o comando npm cache clean --force.

2. Vá em Aplicativos Instalados e desinstale o Node.js.

3. Reinicie o computador.

4. Remova os seguintes diretórios, se existirem:

C:\Program Files (x86)\Nodejs
C:\Program Files\Nodejs
C:\Users\{User}\AppData\Roaming\npm
C:\Users\{User}\AppData\Roaming\npm-cache
C:\Users\{User}\.npmrc
C:\Users\{User}\AppData\Local\Temp\npm-*

5. Volte ao prompt de comando e execute nvm uninstall para cada versão exibida no nvm list:

C:\Users\Hostman>nvm uninstall 18.9.0
Uninstalling node v18.9.0... done

C:\Users\Hostman>nvm uninstall 18.8.0
Uninstalling node v18.9.0... done

C:\Users\Hostman>nvm uninstall 16.17.0
Uninstalling node v18.9.0... done

6. Verifique se as versões foram removidas:

C:\Users\Hostman>nvm list
'nvm' is not recognized as an internal or external command

C:\Users\Hostman>where node
No files matching the pattern were found

C:\Users\Hostman>where npm
No files matching the pattern were found

Instalar Node.js no Windows

Usando o nvm-windows

O Node Version Manager, ou NVM, é um gerenciador de versões do Node.js. Você pode precisar usar diferentes versões do Node e alternar entre elas durante o trabalho.

O NVM é o gerenciador de versões mais comum, mas não está disponível no Windows. Em vez disso, utiliza-se uma versão adaptada chamada nvm-windows.

1. Acesse o repositório do nvm-windows no GitHub.

2. Baixe o instalador nvm-setup.exe para a versão mais recente do gerenciador.

3. Após o download, instale o programa.

4. Quando a instalação terminar, abra o PowerShell como administrador e execute nvm list available para visualizar a lista de versões disponíveis:

Se o seu projeto não exigir uma versão específica, recomendamos escolher a versão LTS mais recente para minimizar possíveis problemas. Se quiser testar novos recursos, você pode instalar a versão mais recente, mas ela pode apresentar maior risco de erros.

Vamos instalar a versão LTS mais recente. Confira o número da versão na saída do nvm list available e instale-a usando nvm install:

PS C:\WINDOWS\system32> nvm install 20.13.1

Downloading node.js version 20.13.1 (64-bit)...
Extracting node and npm...
Complete
npm v10.5.2 installed successfully.
Installation complete. If you want to use this version, type
nvm use 20.13.1

Em alguns casos, durante a instalação do nvm-windows, pode ocorrer um problema: o nvm não carrega o gerenciador de pacotes NPM. Se isso acontecer, recomendamos usar o método de instalação descrito a seguir.

Usando o instalador oficial

1. Acesse a página de downloads no site oficial do Node.js.

2. Selecione e baixe a versão desejada.

3. Após o download, abra o arquivo para iniciar a instalação.

4. Siga as instruções do instalador.

Instalando Node.js no WSL2

Se você deseja usar Node.js com Docker, trabalhar com o terminal Bash ou prefere Linux, pode considerar a instalação do Node.js no WSL2.

WSL (Windows Subsystem for Linux) é uma camada de software que permite a execução de aplicações desenvolvidas para Linux dentro do Windows.

Esta seção mostra as instruções para instalar o WSL2.

O processo de instalação do WSL2 no Windows 10 depende da versão do sistema operacional. Para descobrir, pressione Win+R e digite winver. A seguinte janela será exibida:

Se for Windows 11, você pode seguir diretamente para o Método 1. Se for Windows 10, verifique a versão e o build e selecione o método adequado.

Método 1: Para Windows 10 versão 2004 ou superior, ou Windows 11

Para usar este método, você deve estar no Windows 10 versão 2004 ou posterior (build 19041 ou superior) ou no Windows 11.

No PowerShell, executado como administrador, execute os seguintes comandos:

wsl --install
wsl --set-version Ubuntu 2

Para verificar o resultado, use o comando wsl.exe -l -v:

PS C:\WINDOWS\system32> wsl.exe -l -v
   NAME STATE VERSION
* Ubuntu Stopped 2

Método 2: Para versões do Windows 10 anteriores à 2004

Para este método, você precisa ter no mínimo a versão 1903 ou posterior, com build 18362.1049 ou superior.

Abra o PowerShell como administrador e ative o Windows Subsystem for Linux:

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart

Depois, ative o recurso Plataforma de Máquina Virtual:

dism.exe /online /enable-feature /featurename: VirtualMachinePlatform /all /norestart

Depois de concluir essas etapas, reinicie o computador.

Quando o computador reiniciar, baixe e instale o pacote de atualização do kernel Linux no site oficial da Microsoft.

No PowerShell, defina o WSL versão 2 como padrão:

wsl --set-default-version 2

Agora vamos baixar uma distribuição Linux. Você pode fazer isso diretamente pela Microsoft Store.

Após a instalação, você poderá acessar o terminal do sistema Linux instalado usando o menu de busca.

Conclusão

Node.js é um ambiente de desenvolvimento popular utilizado por grandes empresas como PayPal, Yahoo, Ebay, General Electric, Microsoft e Uber.

Neste guia, analisamos diferentes formas de instalar o Node.js no Windows 10 e 11.

Você pode visitar nossa plataforma de aplicativos para encontrar vários frameworks Node.js, incluindo Express, Fastify, Hapi e Nest.