Como instalar uma versão específica do node.js?

Tutorial para qualquer sistema operacional, utilizando o NVM (Node Version Manager) e FNM (Fast Node Manager).

O que você encontrará no artigo?

1. Instalar uma versão do node específica através do NVM ou FNM
2. O que é NVM e FNM?
3. Como usar e alternar entre as versões instaladas do Node.js

O que é NVM?

Para entender o que é o NVM, bora relembrar que o node.js é uma plataforma que permite rodar JavaScript fora do navegador (como em servidores, por exemplo). Com o NVM, você pode ter várias versões do Node.js instaladas no seu sistema e alternar entre elas facilmente. Isso é muito útil porque alguns projetos podem precisar de uma versão específica do Node.js para funcionar corretamente.

Ou seja, para instalarmos uma versão específica do node usamos o NVM. Então, bora começar instalando o NVM na nossa máquina.

Como instalar o NVM?

Caso você não tenha certeza se já possui o NVM instalado, pode verificar rodando o seguinte comando no terminal:

nvm --version

É importante destacar que para Windows o NVM pode ser mais complexo de configurar e usar, por isso, é recomendado usar o FNM. Você pode ver sobre o que é e como instalar descendo até o final do artigo.

Linux ou MacOS

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

Como instalar uma versão específica do node.js?

Linux ou MacOS

nvm install VERSAO_DESEJADA

Se quisermos baixar a versão 18 do node, seguindo o exemplo acima fariamos:

nvm install 18

E para começar a usar a versão baixada basta seguir o comando. Este comando serve para ficar alternando entre as versões instaladas do node.

nvm use 18

node -v # verificamos se está funcionando, deve sair `v18.20.5`

Instalação no Windows através do FNM

Embora o NVM seja a opção mais popular, sua instalação no Windows pode ser mais complexa. Portanto, recomendo usar o FNM (Fast Node Manager), que é uma alternativa mais rápida e fácil de configurar no Windows.

O que é FNM?

Assim como o NVM, ele é uma ferramenta de gerenciamento de versões do node porém com a proposta de ser mais rápida. Para windows, ele é muito mais otimizado, facilitando sua instalação e uso em comparação com o NVM.

Como instalar o FNM?

Primeiro, você precisa ter o winget instalado no seu sistema (geralmente já vem instalado no Windows 10/11). Para instalar o FNM usando o winget, basta rodar o seguinte comando no PowerShell ou Prompt de Comando:

winget install Schniz.fnm # instala o fnm

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

Instalar uma versão específica do Node.js usando o FNM

Este comando serve para ficar alternando entre as versões instaladas do node, e instala caso não tenha sido instalada ainda.

fnm use --install-if-missing VERSAO_DESEJADA

Se quisermos baixar a versão 18 do node, seguindo o exemplo acima fariamos:

fnm use --install-if-missing 18

# verifica a versão do Node.js está correta
node -v # deve sair `v18.20.5`