Instalar o Node.js no Windows

Artigo
12/20/2023

Se você é iniciante no desenvolvimento com o Node.js e quer aprender a usá-lo rapidamente, siga as etapas abaixo para instalar o Node.js diretamente no Windows.

Observação

Se você está usando o Node.js em um contexto profissional, considera a velocidade de desempenho e a compatibilidade de chamadas do sistema importantes, deseja executar contêineres do Docker que aproveitam os workspaces do Linux e evita a necessidade de manter os scripts de build do Linux e do Windows ou simplesmente prefere usar uma linha de comando do Bash, instale o Node.js no Subsistema do Windows para Linux (mais especificamente, no WSL 2).

Instalar NVM-Windows, Node.js e NPM

Além de você escolher se deseja instalá-lo no Windows ou no WSL, há opções adicionais a serem feitas ao instalar o Node.js. É recomendável usar um gerenciador de versão, pois as versões mudam muito rapidamente. Provavelmente, você precisará alternar entre várias versões do Node.js de acordo com as necessidades de diferentes projetos nos quais você está trabalhando. O Node Version Manager, mais comumente chamado de NVM, é a maneira mais popular de instalar várias versões do Node.js, mas só está disponível para Mac/Linux e não tem suporte no Windows. Em vez disso, recomendamos instalar o nvm-windows e usá-lo para instalar o Node.js e o npm (Gerenciador de Pacotes do Node). Há gerenciadores de versão alternativos que serão considerados e abordados na próxima seção.

Importante

É sempre recomendável remover todas as instalações existentes do Node.js ou do NPM do seu sistema operacional antes de instalar um gerenciador de versão, pois os diferentes tipos de instalação podem levar a conflitos estranhos e confusos. Isso inclui a exclusão de diretórios de instalação do Node.js existentes (por exemplo, "C:\Arquivos de Programas\nodejs") que possam permanecer. O link simbólico gerado pelo NVM não substituirá um diretório de instalação existente (mesmo vazio). Para obter ajuda com a remoção de instalações anteriores, confira Como remover completamente o Node.js do Windows.

Aviso

A NVM foi projetada para ser instalada por usuário e invocada por shell. Ela não foi projetada para caixas de desenvolvedor compartilhadas nem servidores de build com vários agentes de build. A NVM funciona usando um link simbólico. O uso da NVM em cenários compartilhados cria um problema porque esse link aponta para a pasta de dados do aplicativo de um usuário. Portanto, se o usuário x executar nvm use lts, o link apontará o nó da caixa inteira para a pasta de dados do aplicativo. Se o usuário y executar o nó ou o npm, eles serão direcionados para executar arquivos na conta de usuário de x e, no caso de npm -g, eles modificarão os arquivos de x, o que, por padrão, não é permitido. Portanto, a NVM só é prescrita para uma caixa de desenvolvedor. Isso também vale para servidores de build. Se dois agentes de build estiverem na mesma VM/caixa, eles poderão competir e causar um comportamento estranho nos builds.

Siga as instruções de instalação no repositório windows-nvm. É recomendável usar o instalador, mas se você tiver uma compreensão mais avançada das suas necessidades, considere realizar uma instalação manual. O instalador vai redirecionar você para a páginas de versões da versão mais recente.
Baixe o arquivo nvm-setup.zip para obter a versão mais recente.
Depois de baixado, abra o arquivo zip e abra o arquivo nvm-setup.exe.
O assistente de instalação Setup-NVM-for-Windows guiará você pelas etapas de instalação, incluindo a escolha do diretório onde NVM-Windows e Node.js serão instalados.
Quando a instalação for concluída. Abra o PowerShell (é recomendável abrir com permissões de Administrador com privilégios elevados) e tente usar windows-nvm para listar quais versões do Node estão instaladas no momento (não deve haver nenhuma neste momento): nvm ls
Instale a versão atual do Node.js (para testar os aprimoramentos dos recursos mais recentes, mas com mais probabilidade de ter problemas do que a versão LTS): nvm install latest
Instale a versão mais recente do LTS estável do Node.js (recomendada) examinando primeiro qual é o número de versão atual do LTS: nvm list available, em seguida, instale o número de versão do LTS com: nvm install <version> (substitua <version> pelo número, ou seja: nvm install 12.14.0).
Liste quais versões do Node estão instaladas: nvm ls ... agora você deve ver listadas as duas versões que acabou de instalar.
Depois de instalar os números de versão do Node.js de que você precisa, selecione a versão que deseja usar inserindo nvm use <version> (substituindo <version> pelo número, ou seja: nvm use 12.9.0).
Para alterar a versão do Node.js que você deseja usar para um projeto, crie um diretório de projeto mkdir NodeTest e insira o diretório cd NodeTest. Em seguida, digite nvm use <version> substituindo <version> pelo número de versão que deseja usar (como v10.16.3).
Verifique qual versão do NPM está instalada com: npm --version, este número de versão será alterado automaticamente para qualquer versão do NPM associada à sua versão atual do Node.js.

Gerenciadores de versão alternativos

Embora o Windows-NVM seja atualmente o gerenciador de versão mais popular para o nó, há alternativas a serem consideradas:

O nvs (Node Version Switcher) é uma alternativa nvm multiplataforma com a capacidade de integração ao VS Code.
O Volta é um novo gerenciador de versão da equipe do LinkedIn que alega uma velocidade aprimorada e suporte multiplataforma.

Para instalar o Volta como seu gerenciador de versão (em vez do Windows-NVM), vá para a seção Instalação do Windows de seu guia de Introdução, em seguida, baixe e execute o instalador do Windows Installer, seguindo as instruções de instalação.

Importante

Você precisa garantir que o Modo de Desenvolvedor esteja habilitado no computador Windows antes de instalar o Volta.

Para saber mais sobre como usar o Volta para instalar várias versões do Node.js no Windows, confira os Documentos do Volta.

Instalar o Visual Studio Code

Recomendamos que você instale o Visual Studio Code para desenvolver com o Node.js no Windows. Para obter ajuda, confira Tutorial do Node.js no Visual Studio Code.

Editores de código alternativos

Se você preferir usar um editor de código ou um IDE diferente do Visual Studio Code, as seguintes opções também serão boas para seu ambiente de desenvolvimento do Node.js:

Instalar o Git

Se você pretende colaborar com outras pessoas ou hospedar seu projeto em um site de software livre (como o GitHub), o VS Code é compatível com o controle de versão com o Git. A guia Controle do Código-fonte no VS Code acompanha todas as alterações e tem comandos Git comuns (add, commit, push e pull) incorporados diretamente na interface do usuário. Primeiro, você precisa instalar o Git para ativar o painel Controle do Código-fonte.

Baixe e instale o Git para Windows no site do git-scm.
Um Assistente de Instalação está incluído e fará uma série de perguntas sobre as configurações da instalação do Git. Recomendamos o uso de todas as configurações padrão, a menos que você tenha um motivo específico para alterar algo.
Se você nunca trabalhou com o Git antes, os Guias do GitHub podem ajudar você a começar a usá-lo.
É recomendável adicionar um arquivo .gitignore aos seus projetos do Node. Este é o modelo de gitignore padrão do GitHub para Node.js.

Usar o Subsistema do Windows para Linux para produção

O uso do Node.js diretamente no Windows é ótimo para aprender e experimentar o que você pode fazer. Quando você estiver pronto para criar aplicativos Web prontos para produção, que normalmente são implantados em um servidor baseado em Linux, recomendamos o uso do Subsistema do Windows para Linux versão 2 (WSL 2) para o desenvolvimento de aplicativos Web Node.js. Muitos pacotes e estruturas do Node.js são criados com um ambiente nix* em mente e a maioria dos aplicativos Node.js é implantada no Linux. Portanto, o desenvolvimento em WSL garante a consistência entre seus ambientes de desenvolvimento e de produção. Para configurar um ambiente de desenvolvimento WSL, confira Configurar o ambiente de desenvolvimento do Node.js com o WSL 2.