Skip to content

Como instalar o Node.js

O Node.js pode ser instalado de diferentes maneiras. Esta postagem destaca as mais comuns e convenientes. Pacotes oficiais para todas as principais plataformas estão disponíveis em https://nodejs.org/download/.

Uma maneira muito conveniente de instalar o Node.js é através de um gerenciador de pacotes. Nesse caso, cada sistema operacional tem o seu próprio.

Instalação com gerenciador de pacotes

Em macOS, Linux e Windows, você pode instalar assim:

bash
# instala o nvm (Node Version Manager)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash

# baixa e instala o Node.js (você pode precisar reiniciar o terminal)
nvm install 20

# verifica se a versão correta do Node.js está no ambiente
node -v # deve imprimir `v20.17.0`

# verifica se a versão correta do npm está no ambiente
npm -v # deve imprimir `10.8.2`
bash
# instala o fnm (Fast Node Manager)
curl -fsSL https://fnm.vercel.app/install | bash

# ativa o fnm
source ~/.bashrc

# baixa e instala o Node.js
fnm use --install-if-missing 20

# verifica se a versão correta do Node.js está no ambiente
node -v # deve imprimir `v20.17.0`

# verifica se a versão correta do npm está no ambiente
npm -v # deve imprimir `10.8.2`
bash
# NOTA:
# O Homebrew não é um gerenciador de pacotes Node.js.
# Certifique-se de que ele já esteja instalado em seu sistema.
# Siga as instruções oficiais em https://brew.sh/
# O Homebrew só suporta a instalação de versões principais do Node.js e pode não suportar a versão mais recente do Node.js da linha de lançamento 20.

# baixa e instala o Node.js
brew install node@20

# verifica se a versão correta do Node.js está no ambiente
node -v # deve imprimir `v20.17.0`

# verifica se a versão correta do npm está no ambiente
npm -v # deve imprimir `10.8.2`
bash
# NOTA:
# O Docker não é um gerenciador de pacotes Node.js.
# Certifique-se de que ele já esteja instalado em seu sistema.
# Siga as instruções oficiais em https://docs.docker.com/desktop/
# Imagens do Docker são fornecidas oficialmente em https://github.com/nodejs/docker-node/

# baixa a imagem do Docker do Node.js
docker pull node:20-alpine

# verifica se a versão correta do Node.js está no ambiente
docker run node:20-alpine node -v # deve imprimir `v20.17.0`

# verifica se a versão correta do npm está no ambiente
docker run node:20-alpine npm -v # deve imprimir `10.8.2`

No Windows, você pode instalar assim:

bash
# instala o fnm (Fast Node Manager)
winget install Schniz.fnm

# configura o ambiente fnm
fnm env --use-on-cd | Out-String | Invoke-Expression

# baixa e instala o Node.js
fnm use --install-if-missing 20

# verifica se a versão correta do Node.js está no ambiente
node -v # deve imprimir `v20.17.0`

# verifica se a versão correta do npm está no ambiente
npm -v # deve imprimir `10.8.2`
bash
# NOTA:
# O Chocolatey não é um gerenciador de pacotes Node.js.
# Certifique-se de que ele já esteja instalado em seu sistema.
# Siga as instruções oficiais em https://chocolatey.org/
# O Chocolatey não é mantido oficialmente pelo projeto Node.js e pode não suportar a versão v20.17.0 do Node.js

# baixa e instala o Node.js
choco install nodejs-lts --version="20.17.0"

# verifica se a versão correta do Node.js está no ambiente
node -v # deve imprimir `20`

# verifica se a versão correta do npm está no ambiente
npm -v # deve imprimir `10.8.2`
bash
# NOTA:
# O Docker não é um gerenciador de pacotes Node.js.
# Certifique-se de que ele já esteja instalado em seu sistema.
# Siga as instruções oficiais em https://docs.docker.com/desktop/
# Imagens do Docker são fornecidas oficialmente em https://github.com/nodejs/docker-node/

# baixa a imagem do Docker do Node.js
docker pull node:20-alpine

# verifica se a versão correta do Node.js está no ambiente
docker run node:20-alpine node -v # deve imprimir `v20.17.0`

# verifica se a versão correta do npm está no ambiente
docker run node:20-alpine npm -v # deve imprimir `10.8.2`

O nvm é uma maneira popular de executar o Node.js. Ele permite que você alterne facilmente a versão do Node.js e instale novas versões para testar e reverter facilmente se algo falhar. Também é muito útil para testar seu código com versões antigas do Node.js.

TIP

Veja https://github.com/nvm-sh/nvm para mais informações sobre esta opção.

Em qualquer caso, quando o Node.js estiver instalado, você terá acesso ao programa executável node na linha de comando.