Partilhar via

Instalar Node.js no Windows

  • Artigo

Este guia irá ajudá-lo a instalar Node.js em um ambiente de desenvolvimento do Windows.

Para aqueles que preferem usar Node.js em um ambiente Linux, consulte Instalar Node.js no Subsistema Windows para Linux (WSL2).

Considere o seguinte ao decidir onde instalar e se deve desenvolver com Node.js em um ambiente nativo Windows em comparação com Linux (WSL 2):

  • Nível de habilidade: Se você é novo no desenvolvimento com Node.js e quer começar a trabalhar rapidamente para que você possa aprender, instalar Node.js no Windows. Instalar e usar o Node.js no Windows fornecerá um ambiente menos complexo para iniciantes do que usar o WSL.
  • ferramenta de cliente de linha de comando: Se preferir o PowerShell, use Node.js no Windows. Se preferir o Bash, use Node.js no Linux (WSL 2).
  • do servidor de produção: se você planeja implantar seu aplicativo Node.js no Windows Server, use Node.js no Windows. Se você planeja implantar em um servidor Linux, use Node.js no Linux (WSL 2). O WSL permite que você instale sua distribuição Linux preferida (com o Ubuntu como padrão), garantindo a consistência entre seu ambiente de desenvolvimento (onde você escreve código) e seu ambiente de produção (o servidor onde seu código é implantado).
  • Velocidade de desempenho e compatibilidade de chamadas do sistema: Há um debate contínuo e desenvolvimento sobre o desempenho Linux vs Windows, mas a chave ao usar uma máquina Windows é manter seus arquivos de projeto de desenvolvimento no mesmo sistema de arquivos onde você instalou Node.js. Se você instalar Node.js no sistema de arquivos do Windows, mantenha seus arquivos em uma unidade do Windows (por exemplo, C:/). Se você instalar Node.js em uma distribuição Linux (como o Ubuntu), mantenha seus arquivos de projeto no diretório do sistema de arquivos Linux associado à distribuição que você está usando. (Digite explorer.exe . na linha de comando de distribuição WSL para navegar no diretório usando o Explorador de Arquivos do Windows.)
  • contêineres do Docker: Se você quiser usar contêineres do Docker para desenvolver seu projeto no Windows, recomendamos que você Instalar o Docker Desktop no Windows. Para usar o Docker em um espaço de trabalho do Linux, consulte configurar o Docker Desktop para Windows com o WSL 2 para evitar a necessidade de manter scripts de compilação do Linux e do Windows.

Instalar nvm-windows, node.jse npm

Além de escolher se deseja instalar no Windows ou WSL, há opções adicionais a fazer ao instalar Node.js. Recomendamos o uso de um gerenciador de versões, pois as versões mudam muito rapidamente. Você provavelmente precisará alternar entre várias versões Node.js com base nas necessidades de diferentes projetos em que 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 é suportado no Windows. Em vez disso, recomendamos instalar o nvm-windows e, em seguida, usá-lo para instalar o Node.js e o Node Package Manager (npm). Há também gerenciadores de versões alternativas a considerar, que são abordados na próxima seção.

Importante

É sempre recomendável remover quaisquer instalações existentes de Node.js ou npm do seu sistema operacional antes de instalar um gerenciador de versões, pois os diferentes tipos de instalação podem levar a conflitos estranhos e confusos. Isso inclui excluir quaisquer diretórios de instalação de Node.js existentes (por exemplo, "C:\Program Files\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, consulte Como remover completamente node.js do Windows.)

Advertência

O NVM foi projetado para ser instalado por usuário e invocado por shell. Ele não foi projetado para caixas de desenvolvedor compartilhadas ou servidores de compilação com vários agentes de compilação. O NVM funciona usando um link simbólico. Usar nvm em cenários partilhados cria um problema porque esse link aponta para a pasta de dados da aplicação de um utilizador -- portanto, se o utilizador x executar nvm use lts, o link apontará o nó da caixa inteira para a pasta de dados da aplicação do utilizador. Se o utilizador y executar Node.js ou npm, será direcionado para executar ficheiros na conta de utilizador de x e, no caso de npm -g, estará a modificar os ficheiros de x, o que por padrão não é permitido. Portanto, o nvm é prescrito apenas para uma caixa de desenvolvedor. Isso também vale para servidores de compilação. Se dois agentes de compilação estiverem na mesma máquina virtual/servidor, podem competir e causar comportamentos estranhos nas compilações.

  1. Siga as instruções de instalação no repositório nvm-windows. Recomendamos o uso do instalador, mas se você tiver uma compreensão mais avançada de suas necessidades, você pode querer considerar a instalação manual. O instalador irá apontá-lo para a página de lançamentos para a versão mais recente.

  2. Faça o download do arquivo nvm-setup.zip para a versão mais recente.

  3. Uma vez baixado, abra o arquivo zip e, em seguida, abra o arquivo nvm-setup.exe.

  4. O assistente de instalação do Setup-NVM-for-Windows orientará você pelas etapas de configuração, incluindo a escolha do diretório onde o nvm-windows e o Node.js serão instalados.

    assistente de instalação do NVM para Windows

  5. Quando a instalação estiver concluída. Abra o PowerShell (recomende abrir com permissões de administrador elevadas) e tente usar nvm-windows para listar quais versões do Node estão atualmente instaladas (deve ser nenhuma neste momento): nvm ls

    lista NVM sem mostrar versões do Node

  6. Instale a versão atual do Node.js (para testar as melhorias de recursos mais recentes, mas com maior probabilidade de ter problemas do que a versão LTS): nvm install latest

  7. Instale a versão LTS estável mais recente do Node.js (recomendado) determinando primeiro qual é o número da versão LTS atual com: nvm list available, e, em seguida, instalando o número da versão LTS com: nvm install <version> (substituindo <version> pelo número, por exemplo: nvm install 12.14.0).

    lista NVM de versões disponíveis

  8. Listar quais versões do Node estão instaladas: nvm ls ... Agora você deve ver as duas versões que você acabou de instalar listadas.

    lista NVM mostrando as versões de Node.js instaladas

  9. Depois de instalar os Node.js números de versão que você precisa, selecione a versão que você gostaria de usar, digitando: nvm use <version> (substituindo <version> pelo número, ou seja: nvm use 12.9.0).

  10. Para alterar a versão do Node.js você gostaria de usar para um projeto, crie um novo diretório de projeto mkdir NodeTeste digite o diretório cd NodeTeste, em seguida, digite nvm use <version> substituindo <version> com o número de versão que você gostaria de usar (ou seja, v10.16.3').

  11. Verifique com qual versão do npm está instalada: npm --version, esse número de versão mudará automaticamente para qualquer versão do npm associada à sua versão atual do Node.js.

Gerenciadores de versões alternativas

Embora o NVM para Windows (nvm-windows) seja atualmente o gerenciador de versões mais popular para o Node.js, há alternativas a considerar.

  • nvs (Node Version Switcher) é uma alternativa de nvm multiplataforma com a capacidade de integrar com o VS Code.

  • Volta é um novo gerenciador de versões da equipe do LinkedIn que reivindica velocidade melhorada e suporte multiplataforma.

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

Importante

Você deve garantir que do Modo de Desenvolvedor esteja ativado em sua máquina 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, consulte o Volta Docs.

Instalar o Visual Studio Code

Recomendamos que você instale Visual Studio Code para desenvolver com Node.js no Windows. Para obter ajuda, consulte Node.js tutorial no Visual Studio Code.

Editores de código alternativos

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

Instalar o Git

Se você planeja colaborar com outras pessoas ou hospedar seu projeto em um site de código aberto (como o GitHub), o VS Code suporta controle de versão com o Git. A guia Controle do código-fonte no VS Code rastreia todas as suas alterações e tem comandos comuns do Git (adicionar, confirmar, empurrar, puxar) incorporados diretamente na interface do usuário. Primeiro, você precisa instalar o Git para alimentar o painel de controle do código-fonte.

  1. Baixe e instale o Git para Windows a partir do site do git-scm.

  2. Está incluído um Assistente de Instalação que lhe fará uma série de perguntas sobre as configurações da sua instalação do Git. Recomendamos usar todas as configurações padrão, a menos que você tenha um motivo específico para alterar algo.

  3. Se você nunca trabalhou com o Git antes, Guias do GitHub podem ajudá-lo a começar.

  4. Recomendamos adicionar um arquivo .gitignore aos seus projetos Node. Aqui está modelo gitignore padrão do GitHub para Node.js.

Node.js no Windows Server

Se você estiver na situação (um pouco rara) de precisar hospedar um aplicativo Node.js em um servidor Windows, o cenário mais comum parece ser usando um proxy reverso. Há duas maneiras de fazer isto: 1) usando iisnode ou diretamente . Não mantemos esses recursos e recomendamos usar servidores Linux para hospedar as suas aplicações Node.js.