Todos os produtos
Search
Central de documentação

Alibaba Cloud SDK:Instalar o Node.js no Windows

Última atualização: Jun 28, 2026

Este guia apresenta as etapas detalhadas para instalar o Node.js no Windows.

  1. Acesse o site oficial do Node.js e clique em Download.

    Na página de download, selecione a aba Pre-built Installer. Escolha a versão v20.13.1 (LTS), o sistema operacional Windows e a arquitetura x64. Em seguida, clique no botão Download Node.js v20.13.1.

  2. A página de download oferece vários métodos de instalação, conforme descrito na tabela abaixo.

    Nota

    Recomendamos selecionar uma versão LTS (Long-Term Support). As versões LTS são mais estáveis porque recebem manutenção estendida.

    Método de instalação

    Descrição

    package manager

    Utiliza o gerenciador de pacotes do sistema operacional (como apt, yum ou brew) para instalar o Node.js.

    Pre-built Installer

    Instalador pré-compilado para um sistema operacional específico, como um arquivo .msi para Windows ou um arquivo .pkg para macOS. Esses instaladores incluem o runtime do Node.js, npm e as dependências necessárias.

    Pre-built Binaries

    Arquivos executáveis do Node.js pré-compilados para diversas plataformas. Este método não inclui um assistente; é necessário extrair os arquivos manualmente e configurar as variáveis de ambiente.

    Source Code

    Instala o Node.js a partir do código-fonte. É preciso extrair, configurar e compilar o código-fonte usando comandos ou scripts específicos para concluir a instalação.

  3. Clique duas vezes no instalador baixado e siga o assistente para concluir a instalação.

  4. Pressione Win+R para abrir a caixa de diálogo Executar, digite cmd e clique em OK para abrir o Prompt de Comando.

  5. Insira node -v e npm -v. Se a saída for semelhante à seguinte, a instalação foi bem-sucedida.

    C:\Users\xxx>node -v
    v20.13.1
    C:\Users\xxx>npm -v
    10.5.2
  6. (Opcional) Altere o caminho do módulo global e o caminho do cache do npm.

    Após instalar o Node.js, use o gerenciador de pacotes npm para instalar módulos e bibliotecas (conhecidos coletivamente como pacotes). Por padrão, os caminhos de instalação global e de cache ficam na unidade C:. Siga estas etapas para alterar esses locais.

    1. No diretório de instalação do Node.js, crie duas novas pastas: node_global e node_cache.

    2. Conceda permissões de Write e Modify para ambas as pastas. Clique com o botão direito em cada pasta e selecione Properties > Security. Selecione seu usuário ou grupo, clique em Edit, marque as caixas Allow para Modify e Write e clique em OK.

    3. No Prompt de Comando, execute os seguintes comandos.

      npm config set prefix "D:\ide\nodejs\node_global"
      npm config set cache "D:\ide\nodejs\node_cache"
                
      Importante

      Substitua D:\ide\nodejs pelo diretório real de instalação do Node.js.

    4. Atualize a variável de ambiente.

      Clique com o botão direito em This PC > Properties > Advanced system settings. Na janela Propriedades do Sistema, clique em Environment Variables. Na janela Variáveis de Ambiente, localize a variável Path, selecione-a e clique em Edit. Na lista de caminhos, localize e altere a entrada de C:\Users\<YourUsername>\AppData\Roaming\npm para D:\ide\nodejs\node_global.

    5. Verifique a alteração.

      Execute npm install jquery -g no Prompt de Comando. Se uma pasta jquery aparecer no diretório D:\ide\nodejs\node_global\node_modules, o caminho do módulo global foi alterado com sucesso.