Repolode
tj

tj/n

Uma CLI minimalista baseada em bash para instalar, alternar entre e remover várias versões do Node.js no macOS e Linux.

Alternativa open source a:nvm

Estrelas
19,511
Forks
759
Issues abertas
1
Último commit
há 20 dias

O que é?

n é uma ferramenta de linha de comando para gerenciar várias versões do Node.js. Execute `n <version>` para baixar e ativar uma versão específica, `n lts` para instalar a versão mais recente com suporte de longo prazo ou `n` sem argumentos para escolher entre as versões já armazenadas em cache usando as setas do teclado. A ferramenta evita subshells e alterações nos arquivos de configuração do shell: a versão ativa é simplesmente aquela vinculada ao prefixo do seu PATH.

As versões podem ser especificadas de várias formas: números completos ou parciais, como `8` ou `v6.1`; rótulos como `lts`, `latest` e `current`; codinomes de releases; builds nightly; e `auto`, que lê `.n-node-version`, `.node-version`, `.nvmrc` ou o campo `engines` do package.json. As versões baixadas ficam em cache, então podem ser reinstaladas rapidamente, executadas com `n run` ou usadas para executar um único comando com `n exec`.

A ferramenta é compatível com macOS, Linux, WSL e outros sistemas do tipo Unix, e pode ser instalada pelo npm, Homebrew ou MacPorts. É possível definir um mirror personalizado com `N_NODE_MIRROR`, o que é útil em regiões onde o servidor de download padrão é lento. Também é possível substituir a arquitetura para casos como builds Alpine com musl.

Recursos principais

  • 01Instale e alterne entre versões do Node.js com um único comando, como `n lts` ou `n 20`.
  • 02Seletor interativo para escolher, instalar ou remover versões armazenadas em cache.
  • 03Lê a versão desejada de `.n-node-version`, `.node-version`, `.nvmrc` ou do campo `engines` em package.json.
  • 04Execute ou localize uma versão do Node.js armazenada em cache sem reinstalá-la, usando `n run`, `n which` ou `n exec`.
  • 05Compatível com mirrors personalizados e substituições de arquitetura por meio de variáveis de ambiente.

Casos de uso

  • Alternar entre versões do Node.js em vários projetos numa máquina de desenvolvimento.
  • Instalar uma versão específica do Node.js em CI ou em um contêiner Docker com `--cleanup`.
  • Contornar downloads lentos do servidor padrão configurando o n para usar um mirror regional.
  • Executar os scripts de um projeto com uma versão específica do Node.js usando `n exec`.

Início rápido

  1. 1

    Instale o n pelo npm (é necessário já ter o Node.js instalado)

    npm install -g n
  2. 2

    Instale a versão LTS mais recente do Node.js

    n lts

Antes de usar

  • Compatível apenas com macOS e Linux (incluindo WSL); não funciona em shells nativos do Windows, como o PowerShell.
  • A instalação global no diretório padrão /usr/local pode exigir a alteração da propriedade do diretório ou o uso de um N_PREFIX personalizado.

Em coleções

Tópicos

Perguntas frequentes

O que é n?
Uma CLI minimalista baseada em bash para instalar, alternar entre e remover várias versões do Node.js no macOS e Linux. n é uma ferramenta de linha de comando para gerenciar várias versões do Node.js. Execute `n <version>` para baixar e ativar uma versão específica, `n lts` para instalar a versão mais recente com suporte de longo prazo ou `n` sem argumentos para escolher entre as versões já armazenadas em cache usando as setas do teclado. A ferramenta evita subshells e alterações nos arquivos de configuração do shell: a versão ativa é simplesmente aquela vinculada ao prefixo do seu PATH.
n é gratuito? Qual é a licença?
n é open source sob a licença MIT. Confira os termos da licença antes de usá-lo em produtos comerciais.
n ainda é mantido?
Manutenção ativa. O último commit de n foi em 18 de out. de 2026.
Para que posso usar n?
Alternar entre versões do Node.js em vários projetos numa máquina de desenvolvimento. Instalar uma versão específica do Node.js em CI ou em um contêiner Docker com `--cleanup`. Contornar downloads lentos do servidor padrão configurando o n para usar um mirror regional. Executar os scripts de um projeto com uma versão específica do Node.js usando `n exec`.
Como instalar n?
Instale o n pelo npm (é necessário já ter o Node.js instalado): npm install -g n Instale a versão LTS mais recente do Node.js: n lts
Onde consigo n?
O código-fonte e as instruções de instalação estão no GitHub: https://github.com/tj/n

Resumo gerado por IA a partir do README do projeto. As estatísticas do GitHub são atualizadas diariamente.

Projetos relacionados