Node.js/npm/pnpm

Este artigo aborda como instalar o tempo de execução Node.js e usar gerenciadores de pacotes populares no Ubuntu 26.04.

Opção 1: instalar via nvm (recomendado)

nvm (Node Version Manager) permite instalar e alternar entre várias versões Node.js. É a abordagem mais flexível:

Instalar nvm


curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.1/install.sh | bash

Recarregue sua configuração de shell:


source ~/.bashrc

Usando nvm


# List available LTS versions
nvm ls-remote --lts
 
# Install the latest LTS version
nvm install --lts
 
# Install a specific version
nvm install 24
nvm install 22
 
# Switch versions
nvm use 24
 
# Set default version
nvm alias default 24
 
# List installed versions
nvm ls
 
# Uninstall a version
nvm uninstall 20

Opção 2: instalar via fnm

fnm (Fast Node Manager) é um gerenciador de versão Node.js baseado em Rust que é mais rápido:


# Install fnm
curl -fsSL https://fnm.vercel.app/install | bash
source ~/.bashrc
 
# Install Node.js
fnm install --lts
fnm install 24
 
# Switch versions
fnm use 24
fnm default 24
 
# List installed versions
fnm list

Adicione suporte à troca automática para ~/.bashrc ou ~/.zshrc:


eval "$(fnm env --use-on-cd)"

Isso mudará automaticamente as versões ao entrar em um diretório com um arquivo .node-version.

Opção 3: instalar via apt

Se você precisar apenas de uma versão, poderá usar o repositório oficial do NodeSource:


# Add the NodeSource repository (current LTS Node.js 24 example)
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
 
# Install Node.js (includes npm)
sudo apt install nodejs -y
 
# Verify
node --version
npm --version

Gerenciador de pacotes npm

npm é instalado junto com Node.js e é o gerenciador de pacotes padrão:

Uso Básico


# Initialize a project
npm init -y
 
# Install a dependency
npm install express
 
# Install a dev dependency
npm install --save-dev typescript
 
# Install a tool globally
npm install -g nodemon
 
# Run scripts
npm run dev
npm start
 
# Update dependencies
npm update
npm outdated

Configurar o espelho chinês


npm config set registry https://registry.npmmirror.com

Verifique a configuração:


npm config get registry

pnpm

O pnpm usa hard links e armazenamento endereçável por conteúdo, economizando espaço em disco e proporcionando instalações mais rápidas:

Instalar o pnpm


# Install via npm
npm install -g pnpm
 
# Or standalone installation
curl -fsSL https://get.pnpm.io/install.sh | sh -

Usando pnpm


# Initialize a project
pnpm init
 
# Install dependencies
pnpm add express
pnpm add -D typescript
 
# Install all dependencies
pnpm install
 
# Run scripts
pnpm dev
pnpm start
 
# Update dependencies
pnpm update
 
# Manage global packages
pnpm add -g nodemon

Configurar espelho


pnpm config set registry https://registry.npmmirror.com

Espaços de trabalho pnpm (Monorepo)

Crie pnpm-workspace.yaml na raiz do projeto:


packages:
  - 'packages/*'
  - 'apps/*'


# Install a dependency in a specific package
pnpm --filter @myapp/web add react
 
# Run a command across all packages
pnpm -r run build

Fio

Yarn é outro gerenciador de pacotes popular:

Instale o fio


# Enable via corepack
# Note: as of Node.js 25, corepack is no longer bundled with official distributions and must be installed separately
# (Node.js 24 LTS and earlier still bundle corepack, so you can skip the next line)
npm install -g corepack
corepack enable
corepack prepare yarn@stable --activate
 
# Or install via npm
npm install -g yarn

Usando Fio


# Initialize a project
yarn init -2
 
# Install dependencies
yarn add express
yarn add --dev typescript
 
# Install all dependencies
yarn install
 
# Run scripts
yarn dev

Pacote principal

Corepack é uma ferramenta Node.js para gerenciar gerenciadores de pacotes, garantindo que os projetos usem a versão especificada do pnpm ou do fio. A partir de Node.js 25 ele não está mais incluído nas distribuições oficiais e deve ser instalado primeiro com npm install -g corepack; Node.js 24 LTS e anteriores ainda agrupam:


# Node.js 25+ needs corepack installed first (skip on 24 LTS and earlier)
npm install -g corepack
 
# Enable corepack
corepack enable
 
# Specify the package manager in package.json
# "packageManager": "pnpm@9.15.0"

Isso garante que os membros da equipe usem automaticamente a versão correta do gerenciador de pacotes após clonar o projeto.

Perguntas frequentes

Problemas globais de permissão de instalação

Node.js instalado via nvm ou fnm não requer privilégios sudo. Se instalado via apt, você poderá encontrar problemas de permissão:


# Change the npm global install directory
mkdir -p ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

Arquivo .nvmrc

Crie um arquivo .nvmrc na raiz do projeto para especificar a versão Node.js:


echo "24" > .nvmrc
nvm use  # Automatically reads .nvmrc

Escolher o gerenciador de versão e gerenciador de pacotes Node.js correto pode melhorar significativamente sua experiência de desenvolvimento de JavaScript front-end e back-end.