Como instalar Node.js e npm no Mac

Instalar Node.js e npm no Mac

Como instalar Node.js e npm no Mac (4 formas, mais soluções) | We.Inc

Instale Node.js e npm no Mac com o instalador oficial, Homebrew, nvm ou fnm. Copie os comandos exatos, confira a instalação e corrija os erros EACCES e command not found.

O npm vem junto com o Node.js, então instalar o Node também instala o npm. No Mac você pode usar o instalador do nodejs.org, rodar brew install node ou usar um gerenciador de versões como nvm ou fnm. Um gerenciador de versões é a escolha mais segura para desenvolvedores, porque evita erros de permissão e troca de versão por projeto.

Quatro formas de instalar, comparadas

Todo tutorial de Node.js para Mac escolhe um método e ignora os outros, e depois deixa você travado quando o npm reclama de permissões. Esta página coloca os quatro lado a lado, com os comandos conferidos na documentação de cada projeto, um seletor que mostra só os passos de que você precisa e um corretor de erros para as mensagens mais comuns.

Perguntas frequentes

Instalar o Node.js instala o npm?

Sim. O instalador oficial, a fórmula do Homebrew e os dois gerenciadores de versões instalam npm e npx junto com o node. Você não precisa baixar o npm separado.

Qual versão do Node.js devo instalar?

A linha LTS mais recente. No nodejs.org, em outubro de 2026, é a v24 (Krypton), com a v26 ainda na fase Current. Frameworks como Vite e Next.js também publicam uma versão mínima, então confira a documentação deles se você os usa.

O que significa LTS?

Long Term Support, ou suporte de longo prazo. Uma versão passa cerca de seis meses como Current, depois vai para Active LTS com correções de bugs e de segurança, e depois para Maintenance LTS só com correções críticas. O site do Node.js diz que, a partir da versão 27, toda versão principal vai virar LTS, não só as pares.

Posso instalar o nvm com Homebrew?

O README do nvm diz que a instalação do nvm via Homebrew não é suportada e pede que você use o script de instalação dele. Já o fnm documenta brew install fnm como um caminho normal de instalação.

Como desinstalo um Node.js do Homebrew?

Rode brew uninstall node. Se você está migrando para um gerenciador de versões, faça isso primeiro para que o binário antigo não esconda o novo no seu PATH.

Instalador, Homebrew ou gerenciador de versões?

Conferindo a instalação

Linhas de versão do Node.js em outubro de 2026

Da página de versões anteriores do Node.js

Comandos do dia a dia do gerenciador de versões

Liste o que está instalado, instale outra versão e troque o shell atual para ela.

As mesmas tarefas com o fnm. Com --use-on-cd na configuração do shell, entrar em uma pasta com .node-version ou .nvmrc troca a versão para você.

Baixe o instalador para macOS da versão LTS no nodejs.org e abra-o.

Avance pelo instalador, depois abra uma nova janela do Terminal e confira os dois comandos.

Antes de instalar pacotes globalmente, aponte o npm para uma pasta que é sua, assim você nunca precisa de sudo.

Instale a versão mais nova, que inclui node, npm e npx.

Ou fique em uma linha LTS com uma fórmula com versão. Fórmulas com versão são keg-only, então siga a linha de PATH que o brew mostra depois.

Confira o resultado em uma nova janela do Terminal.

Rode o script de instalação do README do nvm (v0.40.8 no momento em que escrevemos; o README sempre mostra a mais recente).

Abra uma nova janela do Terminal, depois instale a LTS mais recente e defina-a como padrão.

Fixe uma versão por projeto com um arquivo .nvmrc e troque para ela com nvm use.

Instale o fnm com Homebrew.

Adicione a linha de configuração do shell ao ~/.zshrc para que o fnm carregue e troque de versão quando você mudar de pasta.

Instale a LTS mais recente e confira.

EACCES: permission denied

O npm tentou gravar em uma pasta do sistema. Não use sudo. Mude para nvm ou fnm, ou defina o prefix do npm como ~/.local, como mostrado nos passos do instalador, e depois reinstale o pacote global.

command not found: node ou npm

O shell não encontra o binário. Primeiro abra uma nova janela do Terminal. Se ainda falhar, rode which node e confira se a linha de PATH do Homebrew ou a linha de configuração do seu gerenciador de versões está no ~/.zshrc.

command not found: nvm

O nvm é uma função do shell carregada por linhas que o instalador adiciona ao seu perfil. Abra uma nova janela, ou garanta que o ~/.zshrc existe antes de rodar o instalador, e rode-o de novo.

Engine não suportada ou versão errada do Node.js

O pacote pede uma versão do Node.js diferente da que está rodando. Confira node -v, instale a versão de que o projeto precisa e fixe-a com .nvmrc ou .node-version.

EADDRINUSE: address already in use

O Node.js funciona; outro processo já está usando a porta. Veja o guia de localhost:3000 para os comandos que encontram e encerram esse processo.

Instalador oficial

Homebrew

Todos os métodos

Passos de instalação por método

Método de instalação

Passo {n}

Copiar

Corretor de erros

Cole a mensagem de erro do Terminal

npm ERR! code EACCES

Nenhum padrão conhecido encontrado. Todas as soluções estão listadas abaixo.

Causa provável encontrada: {v}

Comece grátis · Sem cartão de crédito

Relacionados: Guias

Produto

Para quem é

Recursos

Recursos

Empresa

Mapa do site