Configurando o Ambiente Node.js no Windows

  1. Instalação

Para instalar o Node.js no Windows, baixe o instalador apropriado para sua arquitetura (32 ou 64 bits). Recomendamos o formato MSI por ser um instalador completo.

O instalador MSI gerencia a instalação, modificação e desinstalação de progrramas. O formato ZIP, por outro lado, é um arquivo compactado que não requer um processo de instalação formal.

Após o download, execute o arquivo MSI e siga as instruções, clicando em "Next" (Próximo). A instalação padrão ocorre em C:\Program Files, mas você pode customizar o caminho.

Durante a instalação, você terá opções como:

  • npm package manager: Gerenciador de pacotes NPM.
  • online documentation shortcuts: Atalhos para a documentação online.
  • Add to PATH: Adicionar o diretório de instalação do Node.js à variável de ambiente PATH.

Após a instalação, é crucial verificar se o Node.js foi adicionado corretamente ao PATH. Se você utilizou o instalador MSI e selecionou "Add to PATH", o executável node.exe já estará acessível globalmente. Caso tenha optado pelo formato ZIP, será necessário adicionar manualmente o diretório onde o node.exe foi extraído à variável de ambiente PATH do sistema.

Para confirmar a instalação, abra o Prompt de Comando (CMD) e execute:

node -v

Isso exibirá a versão do Node.js instalada.

O Node.js geralmente vem acompanhado do NPM (Node Package Manager). Verifique a versão do NPM com:

npm -v
  1. Alterando o Diretório Padrão de Pacotes Globais

Por padrão, os pacotes instalados globalmente (usando npm install -g nome_do_pacote) são armazenados em C:\Users\seu_usuario\AppData\Roaming\npm\node_modules. Você pode verificar o local atual com:

npm root -g

Para personalizar este local, execute os seguintes comandos no CMD:

npm config set prefix "C:\node\node_global"
npm config set cache "C:\node\node_cache"

Alternativamente, você pode editar o arquivo .npmrc na pasta de configuração do NPM (geralmente %AppData%\npm ou C:\Users\seu_usuario\.npmrc) e adicionar as seguintes linhas:

prefix =C:\node\node_global
cache = C:\node\node_cache

Essas configurações definirão C:\node\node_global como o diretório para pacotes globais e C:\node\node_cache para o cache do NPM. O diretório node_global será criado automaticamente se não existir, e o diretório de cache node_cache será criado na primeira vez que um pacote global for baixado.

  1. Configurando a Variável de Ambiente para Pacotes Globais

Ao alterar o diretório de pacotes globais, é necessário informar ao sistema onde encontrar os executáveis desses pacotes. Por exemplo, se você instalar o Vue CLI globalmente:

npm install @vue/cli -g

Os executáveis, como o comando vue, estarão localizados em C:\node\node_global (ou o diretório que você definiu como prefix). Se este diretório não estiver no PATH do sistema, comandos como vue create meu_projeto não serão reconhecidos.

Para resolver isso, adicione o diretório prefix (C:\node\node_global no exemplo) à sua variável de ambiente PATH.

Após adicionar o diretório ao PATH e reiniciar o Prompt de Comando, o comando vue deverá funcionar corretamente.

Tags: Node.js npm Variáveis de Ambiente Windows Instalação

Publicado em 7-17 18:46