Comandos para Desenvolvedores Node.js

# Gerenciamento de pacotes
npm install                    # instala todas as dependências
npm install zod                # adiciona uma dependência
npm install -D vitest          # adiciona uma dependência de desenvolvimento
npm run dev                    # inicia o servidor de desenvolvimento
npm run build                  # build de produção
 
# Gerenciamento de versão do Node
nvm install 22                 # instala Node 22
nvm use 22                     # muda para Node 22
node -v                        # verifica a versão do Node
 
# Ambiente
export PORT=3001               # define a variável de ambiente para esta sessão
cat .env.local                 # visualiza o arquivo .env
echo $NODE_ENV                 # verifica o ambiente atual
 
# Verificações rápidas
npx tsc --noEmit               # verifica tipos sem construir
npx next lint                  # executa o linter
npx vitest run                 # executa testes uma vez

# Configurando um novo projeto Next.js do zero
npx create-next-app@latest my-app --typescript --tailwind --app --src-dir
cd my-app
npm install zustand zod react-hook-form @hookform/resolvers
npm install -D vitest @testing-library/react
npm run dev
# App rodando em http://localhost:3000

# Instalar
npm install                        # instala a partir do package.json
npm install --legacy-peer-deps     # resolve conflitos de dependência de pares
npm ci                             # instalação limpa (usa o lockfile exatamente, mais rápido em CI)
 
# Adicionar/remover pacotes
npm install lucide-react           # adiciona dependência
npm install -D prettier            # adiciona dependência de desenvolvimento
npm uninstall lodash               # remove um pacote
 
# Inspecionar
npm list --depth=0                 # pacotes instalados de nível superior
npm outdated                       # verifica atualizações
npm audit                          # vulnerabilidades de segurança
npm audit fix                      # corrige automaticamente vulnerabilidades
 
# Scripts
npm run dev
npm run build
npm run start
npm test
npm run lint
 
# Visualizar um pacote antes de instalar
npm info zustand                   # detalhes do pacote
npm info zustand versions          # todas as versões publicadas
 
# Vincular um pacote local para desenvolvimento
cd ../my-library && npm link
cd ../my-app && npm link my-library

# Instalar pnpm
npm install -g pnpm
 
# Comandos equivalentes
pnpm install                       # instala tudo
pnpm add zod                       # adiciona dependência
pnpm add -D vitest                 # adiciona dependência de desenvolvimento
pnpm remove lodash                 # remove
pnpm dev                           # executa script (não precisa de "run")
pnpm build
 
# Comandos de workspace (monorepo)
pnpm -r build                     # executa build em todos os pacotes
pnpm --filter @app/web dev        # executa dev em um pacote específico

# Instalar nvm (macOS/Linux)
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
 
# Instalar e usar uma versão do Node
nvm install 22
nvm install 20
nvm use 22
nvm alias default 22              # define o padrão para novos terminais
 
# Usar versão do arquivo .nvmrc
echo "22" > .nvmrc
nvm use                           # lê .nvmrc
 
# Listar versões instaladas
nvm ls
 
# Listar versões disponíveis
nvm ls-remote | grep "Latest LTS"

# Definir apenas para o comando atual
PORT=3001 npm run dev
NODE_ENV=production npm run build
 
# Definir para a sessão atual
export DATABASE_URL="postgresql://localhost:5432/mydb"
 
# Visualizar variáveis de ambiente atuais
env | grep NODE
printenv PORT
 
# Estrutura do arquivo .env (Next.js)
# .env                - todos os ambientes (commitado)
# .env.local          - substituições locais (ignorado pelo git)
# .env.development    - apenas dev
# .env.production     - apenas prod
# .env.test           - apenas test
 
# Acessar no Next.js
# Servidor: process.env.DATABASE_URL
# Cliente: process.env.NEXT_PUBLIC_API_URL (deve ter o prefixo NEXT_PUBLIC_)
 
# Verificar quais variáveis de ambiente seu aplicativo vê
node -e "console.log(process.env.NODE_ENV)"

# Verificar tipos sem construir
npx tsc --noEmit
 
# Verificar tipos em modo de observação
npx tsc --noEmit --watch
 
# Gerar arquivos de declaração
npx tsc --declaration --emitDeclarationOnly
 
# Verificar tsconfig
npx tsc --showConfig
 
# Encontrar erros de tipo específicos
npx tsc --noEmit 2>&1 | grep "error TS"
 
# Contar erros de tipo
npx tsc --noEmit 2>&1 | grep "error TS" | wc -l
 
# Verificar um arquivo específico
npx tsc --noEmit src/lib/utils.ts

# Build de produção do Next.js
npm run build
# Mostra tamanhos de rota, estático vs dinâmico, detalhamento do bundle
 
# Analisar tamanho do bundle
npm install -D @next/bundle-analyzer
ANALYZE=true npm run build
 
# Verificar tamanho do pacote antes de instalar
npx package-size zustand zod lodash
# ou use https://bundlephobia.com
 
# Medir tempo de build
time npm run build
 
# Verificar o que está em node_modules
du -sh node_modules                    # tamanho total
du -sh node_modules/* | sort -rh | head -20  # pacotes maiores
npx depcheck                           # encontrar dependências não utilizadas

# Depurador do Node.js
node --inspect server.js               # conectar Chrome DevTools
node --inspect-brk server.js           # parar na primeira linha
 
# Depurar um aplicativo Next.js
NODE_OPTIONS='--inspect' npm run dev
 
# Profiling de memória
node --max-old-space-size=4096 server.js   # aumentar heap para 4GB
node --heap-prof server.js                  # gerar perfil de heap
 
# REPL rápido para testes
node
> const { z } = require('zod')
> z.string().email().safeParse('test@example.com')
 
# Executar uma linha de comando
node -e "console.log(Date.now())"
node -e "console.log(require('./package.json').version)"
node -p "require('os').cpus().length"      # -p imprime o resultado
 
# Verificar resolução de módulo
node -e "console.log(require.resolve('react'))"

# Testar um endpoint de API
curl http://localhost:3000/api/health
curl -s http://localhost:3000/api/users | jq .
 
# POST com corpo JSON
curl -X POST http://localhost:3000/api/users \
  -H "Content-Type: application/json" \
  -d '{"name": "Alice", "email": "alice@example.com"}'
 
# POST com cabeçalho de autenticação
curl -H "Authorization: Bearer $TOKEN" \
  http://localhost:3000/api/protected
 
# Medir tempo de uma requisição
curl -o /dev/null -s -w "Total: %{time_total}s\nTTFB: %{time_starttransfer}s\n" \
  http://localhost:3000
 
# Monitorar uma porta
lsof -i :3000                  # o que está usando a porta 3000
kill -9 $(lsof -ti :3000)      # matar o que estiver na porta 3000