Como atualizar o Node.js para a versão LTS atual

Atualizar o Node.js parece uma tarefa de poucos segundos, mas a escolha do método importa mais do que parece. Quem só precisa rodar um projeto novo pode baixar o instalador oficial e seguir o caminho mais simples. Já quem trabalha com múltiplos projetos (cada um exigindo uma versão diferente) precisa de um gerenciador de versões como nvm, fnm ou Volta. E quem administra servidor de produção tem cuidados específicos a tomar antes de qualquer atualização.

Este artigo cobre os 4 caminhos para Windows, macOS e Linux, com os comandos exatos, recomenda qual método escolher por cenário e mostra os erros comuns que aparecem no processo de atualização.

Versões do Node.js em suporte ativo

O Node.js tem dois tipos de versão: LTS (Long-Term Support) e Current. As LTS são lançadas em outubro de cada ano par e recebem 30 meses de suporte: 12 meses como versão ativa e 18 meses como manutenção. As Current têm os recursos mais recentes mas duram só 6 meses.

Em 2026, as versões com suporte ativo são:

Recomendação prática: para produção, use a LTS mais recente que esteja em fase ativa (Node 24.x em 2026). Para experimentar recursos novos sem garantia de estabilidade, use Current. Para projetos legados, mantenha na versão original com package.json configurado.

A versão exata e o cronograma podem ser conferidos no calendário oficial de releases do Node.js (atualizado pelos mantenedores).

Como verificar qual versão você tem instalada

Abra o terminal (PowerShell no Windows, Terminal no macOS/Linux) e rode:

node -v

Vai aparecer algo como v22.11.0. Para verificar o npm que veio junto:

npm -v

Se você nunca instalou Node, o terminal retorna “comando não encontrado”. Nesse caso, é instalação, não atualização — siga o caminho do instalador.

Como atualizar o Node.js no Windows

Existem quatro caminhos práticos:

Método 1: Instalador oficial (.msi)

O caminho mais direto:

1. Acesse nodejs.org/download
2. Baixe o Windows Installer (.msi) da versão LTS
3. Execute o arquivo baixado
4. O instalador detecta a versão antiga e atualiza automaticamente
5. Confirme com node -v no terminal após instalar

Esse método substitui completamente a versão anterior. Bom para quem usa só uma versão e quer simplicidade.

Método 2: Winget (recomendado para Windows 10/11)

O Winget é o gerenciador de pacotes nativo do Windows desde 2020. Abra o PowerShell e rode:

winget upgrade OpenJS.NodeJS

Ou para forçar uma versão específica:

winget install OpenJS.NodeJS.LTS

O Winget é mais rápido que o instalador gráfico e funciona via terminal, o que é prático para devs que já vivem no PowerShell.

Método 3: nvm-windows (múltiplas versões)

O nvm-windows permite ter várias versões do Node instaladas e trocar entre elas conforme o projeto:

nvm install lts
nvm use 22.11.0

Use quando trabalha com vários projetos que exigem versões diferentes. O vídeo abaixo do Tempos Esquisitos mostra a configuração completa do nvm-windows na prática:

Método 4: Chocolatey

Para quem já usa Chocolatey (outro gerenciador de pacotes Windows):

choco upgrade nodejs-lts

Como atualizar o Node.js no macOS

Método 1: Instalador oficial (.pkg)

1. Acesse nodejs.org/download
2. Baixe o macOS Installer (.pkg)
3. Execute o arquivo e siga o assistente
4. Confirme com node -v

Método 2: Homebrew (recomendado)

Se você usa Homebrew (gerenciador de pacotes mais popular no macOS):

brew update
brew upgrade node

Para instalar uma versão específica:

brew install node@22

Método 3: nvm

nvm install --lts
nvm use --lts

Para listar versões disponíveis:

nvm ls-remote

Método 4: fnm (alternativa moderna e mais rápida ao nvm)

O fnm (Fast Node Manager) é uma versão escrita em Rust, mais rápida que nvm tradicional:

brew install fnm
fnm install --lts
fnm use --lts

Funciona em macOS, Linux e Windows com mesma sintaxe.

Como atualizar o Node.js no Linux

Método 1: nvm (recomendado para desenvolvedores)

nvm install --lts
nvm use --lts
nvm alias default lts/*

A última linha define a versão LTS como padrão para novos terminais. Se você não tem nvm instalado:

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash

Método 2: NodeSource (apt no Ubuntu/Debian)

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

Substitua 22.x pela versão LTS desejada. O NodeSource mantém repositórios oficiais e atualizados.

Método 3: dnf/yum (Fedora/RHEL/CentOS)

sudo dnf install nodejs:22

Ou com NodeSource:

curl -fsSL https://rpm.nodesource.com/setup_22.x | sudo bash -
sudo dnf install -y nodejs

Método 4: Snap (Ubuntu/Snap Store)

sudo snap install node --classic --channel=22/stable

Útil em sistemas com Snap pré-instalado, mas não tão usado quanto nvm em ambientes profissionais.

nvm vs fnm vs Volta: qual gerenciador escolher

Recomendação: para começar, nvm é a opção mais documentada. Para devs que querem o mais rápido, fnm. Para times que querem versão fixada por projeto sem ninguém configurar, Volta.

Como atualizar o npm separadamente

O npm vem junto do Node, mas pode (e deve) ser atualizado separadamente. Em qualquer sistema:

npm install -g npm@latest

Versões recentes do npm trazem melhorias de performance, segurança e novos comandos. Vale atualizar de tempos em tempos mesmo que o Node não esteja sendo atualizado.

Como manter múltiplas versões do Node ao mesmo tempo

Quando você tem projetos antigos que rodam só em versões específicas (Node 16, por exemplo) e projetos novos que exigem versões recentes, manter as duas é essencial. Com nvm ou fnm:

# Instalar várias versões
nvm install 18
nvm install 22

# Trocar entre elas
nvm use 18
nvm use 22

# Ver todas instaladas
nvm ls

Versão fixada por projeto com .nvmrc

Crie um arquivo .nvmrc na raiz do projeto com a versão desejada:

22.11.0

Ao entrar na pasta do projeto, rode nvm use (sem argumento) e ele lê o arquivo e troca automaticamente. Quem usa Volta, isso acontece automaticamente sem precisar do comando.

Engines no package.json

Outra forma é declarar a versão no package.json:

{
  "engines": {
    "node": ">=22.0.0",
    "npm": ">=10.0.0"
  }
}

Isso não troca a versão sozinho, mas avisa o usuário e ferramentas de CI se a versão local for incompatível.

Erros comuns ao atualizar e como resolver

“EACCES: permission denied” — você está tentando rodar npm install -g sem permissão. No Linux/macOS, evite usar sudo para npm. Em vez disso, configure o npm para instalar em diretório do usuário:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

“node: command not found” depois de atualizar — o PATH do sistema não está apontando para a nova instalação. Reinicie o terminal. Se persistir, verifique a variável PATH ou reinstale via nvm.

“npm não atualiza junto com node” — npm é instalado separadamente. Após atualizar Node, rode npm install -g npm@latest para garantir a versão mais recente do npm.

Conflito entre Node instalado por instalador e por nvm — pode acontecer se você instalou primeiro pelo instalador oficial e depois pelo nvm. Desinstale a versão do instalador (Painel de Controle no Windows, brew uninstall node no Mac) e use só nvm/fnm/Volta daqui em diante.

Versão antiga aparece mesmo após atualizar (Windows) — pode ser cache do PATH. Feche todos os terminais, reabra e teste. Se ainda aparecer a versão antiga, reinicie o computador.

Cuidados ao atualizar Node.js em servidor de produção

Atualizar Node em servidor que roda aplicação não é o mesmo que atualizar localmente. Antes de qualquer mudança:

1. Verifique se sua aplicação está testada na nova versão. Rode o conjunto de testes com a versão nova localmente antes de atualizar o servidor.

2. Atualize de uma minor de cada vez. Pular muitas versões pode introduzir bugs em dependências antigas.

3. Use rollback strategy. Se você usa nvm em produção, a versão antiga continua instalada. Para voltar, basta nvm use [versão antiga] e reiniciar a aplicação.

4. Cuidado com mudanças em APIs nativas. Algumas dependências usam módulos nativos que precisam ser recompilados quando você muda de versão (npm rebuild).

5. Considere janelas de manutenção. Se a aplicação está em produção crítica, planeje a atualização para horário de baixo tráfego.

Para times que querem trabalhar com ambiente de desenvolvimento profissional, vale conhecer também boas ferramentas. Veja como instalar o Bootstrap no Visual Studio Code para configurar um stack completo de frontend.

Perguntas frequentes

Posso ter Node 18 e Node 22 instalados ao mesmo tempo?

Sim, com nvm, fnm ou Volta. Você instala quantas versões quiser e troca entre elas com um comando. Sem gerenciador de versões, só uma versão por vez fica ativa.

Preciso desinstalar a versão antiga antes de atualizar?

Não, se você usa instalador oficial ou Winget. Esses substituem a versão automaticamente. Com Homebrew (brew upgrade node), também não. Só precisa desinstalar se quer migrar para nvm/fnm/Volta e tem instalação prévia conflitante.

O que LTS significa no Node.js?

LTS é Long-Term Support: versões que recebem 30 meses de suporte (12 ativas + 18 em manutenção). São recomendadas para produção porque garantem correções de segurança e bugs por mais tempo. As versões Current têm apenas 6 meses de suporte e são para experimentar recursos novos.

O npm atualiza junto com o Node.js?

Sim, mas geralmente uma versão atrasada. Após atualizar o Node, rode npm install -g npm@latest para garantir a versão mais nova do npm separadamente.

Como saber qual versão do Node usar em cada projeto?

Verifique o campo engines no package.json do projeto. Se não houver, leia o README ou pergunte ao mantenedor. Em times, é comum ter um .nvmrc na raiz do projeto especificando a versão exata.

nvm funciona no Windows?

O nvm original (do Bash) não, mas existe o nvm-windows, um projeto separado que oferece funcionalidade similar para Windows. Alternativas modernas como fnm e Volta funcionam nativamente em Windows com a mesma sintaxe do macOS/Linux.

Qual é a diferença entre Node atual e Node LTS?

Versões LTS (números pares: 18, 20, 22, 24) são para produção, com 30 meses de suporte. Versões Current (números ímpares: 19, 21, 23) trazem features novas mas têm só 6 meses de suporte, sendo para experimentação.