Instalar o NodeJS no Windows

Artigo
03/03/2023
8 minutos para o fim da leitura

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).

Aviso

Problema de acesso negado no nvm-windows versão 1.1.9, a alternância da versão do nó requer o PowerShell elevado (executado como administrador). É recomendável usar a versão 1.1.7 para evitar esse problema.

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, bem como o Pacote de Extensão do Node.js, para desenvolvimento com o Node.js no Windows. Instale todas ou escolha a que parecer mais útil para você.

Para instalar o pacote de extensão do Node.js:

Abra a janela Extensões (Ctrl + Shift + X) no VS Code.
Na caixa de pesquisa na parte superior da janela Extensões, digite: "Pacote de extensão do Node" (ou o nome da extensão que você está procurando).
Selecione Instalar. Uma vez instalada, sua extensão aparecerá na pasta "Habilitado" da janela Extensões. É possível desabilitar, desinstalar ou definir as configurações selecionando o ícone de engrenagem ao lado da descrição de sua nova extensão.

Algumas extensões adicionais que talvez você queira considerar incluem:

Depurador para Chrome: depois de concluir o desenvolvimento no lado do servidor com o Node.js, você precisará desenvolver e testar o lado do cliente. Essa extensão integra seu editor do VS Code ao serviço de depuração do navegador Chrome, tornando as coisas um pouco mais eficientes.
Mapas de teclas de outros editores: essas extensões poderão ajudar na familiaridade com seu ambiente se você estiver fazendo a transição de outro editor de texto (como Atom, Sublime, Vim, eMacs, Notepad++ etc.).
Sincronização de configurações: permite que você sincronize suas configurações do VS Code em diferentes instalações usando o GitHub. Se você trabalha em diferentes computadores, isso ajuda a manter seu ambiente consistente entre eles.

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.