
Manter o Node.js atualizado evita bugs estranhos e melhora o desempenho no build. A seguir listo os métodos que uso em cada sistema operacional.
1. macOS e Linux com nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.nvm/nvm.sh
nvm install 20
nvm alias default 20
Com isso novos shells já abrem na versão 20.
2. Linux servers com NodeSource
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs
Ideal para pipelines ou servidores sem acesso ao nvm.
3. Windows com nvs
Invoke-WebRequest https://github.com/jasongin/nvs/releases/download/v1.6.2/nvs-1.6.2.zip -OutFile nvs.zip
Expand-Archive nvs.zip -DestinationPath "$env:LOCALAPPDATA\nvs"
$env:PATH = "$env:LOCALAPPDATA\nvs;$env:PATH"
nvs add lts
nvs use lts
4. Conferindo versões globais
node -v
npm -v
corepack enable
O corepack prepara pnpm e yarn com a mesma versão do Node.
5. Automação com CI/CD
Em workflows do GitHub Actions use actions/setup-node@v4 e defina
cache: 'npm' para acelerar o build:
- uses: actions/setup-node@v4
with:
node-version: 20
cache: 'npm'
6. Checklist pós-atualização
- Reinstale dependências (
rm -rf node_modules && npm install). - Rode a suíte de testes e o lint.
- Atualize
.nvmrcepackage.json(engines.node).
Seguindo esses passos você mantém o runtime seguro e consistente em todos os ambientes.