Voltar

Comandos essenciais do npm

Comandos essenciais do npm para desenvolvimento local

Este guia reúne comandos do npm usados com frequência no desenvolvimento local, no gerenciamento de pacotes e na criação de ferramentas de linha de comando.

Vinculação e gerenciamento de pacotes

Vincular um pacote local

Terminal
1cd ~/caminho/para/o/pacote
2npm link
A vinculação é útil para testar pacotes locais sem publicá-los no npm.

Desvincular um pacote local

bash snippet
1cd ~/caminho/para/o/pacote
2npm unlink

Remover um pacote global

bash snippet
1npm rm --global <nome-do-pacote>
Tenha cuidado ao remover pacotes globais, pois outras aplicações podem depender deles.

Verificar os pacotes instalados

bash snippet
1npm list --global
Use npm list sem --global para verificar as dependências do projeto atual.

Execução de pacotes e gerenciamento de cache

Limpar o cache do npx

bash snippet
1rm -rf ~/.npm/_npx

Executar um pacote sem instalação global

bash snippet
1npx <nome-do-pacote>
2# Use @latest para garantir a execução da versão mais recente
3npx <nome-do-pacote>@latest
O npx é útil para executar comandos pontuais ou testar pacotes sem instalá-los globalmente.

Desenvolvimento de CLI com Node.js e TypeScript

Exemplo de configuração do package.json

json snippet
1{
2  "scripts": {
3    "dev": "tsc -w && npm run link",
4    "start": "node dist/index.js",
5    "build": "esbuild src/index.ts --bundle --platform=node --target=node18 --outfile=dist/index.js",
6    "up": "npm run build && npm publish --access public && npm run unlink",
7    "link": "npm unlink your-cli && npm i -g && chmod +x ./dist/index.js && npm link your-cli",
8    "unlink": "npm rm -g your-cli && npm unlink your-cli"
9  },
10  "bin": {
11    "your-cli": "./dist/index.js"
12  }
13}
Essa configuração foi pensada para construir uma ferramenta CLI com Node.js, TypeScript e esbuild.

Gerenciamento de dependências

Instalar as dependências do projeto

bash snippet
1npm install
2# Forma abreviada
3npm i

Instalar um pacote específico

bash snippet
1npm install <nome-do-pacote>
2# Instalar como dependência de desenvolvimento
3npm install <nome-do-pacote> --save-dev

Atualizar dependências

bash snippet
1npm update
2# Atualizar um pacote específico
3npm update <nome-do-pacote>

Gerenciamento de versões

Consultar versões de pacotes

bash snippet
1npm version
2# Consultar a versão de um pacote específico
3npm view <nome-do-pacote> version

Incrementar a versão de um pacote

bash snippet
1npm version patch
2npm version minor
3npm version major
Use versionamento semântico para administrar as versões do pacote de forma previsível.

Publicação de pacotes

Publicar um pacote

bash snippet
1npm publish
Antes de publicar, confirme se o nome do pacote está disponível e se sua conta possui as permissões necessárias.

Publicar um pacote com escopo

bash snippet
1npm publish --access public

Execução de scripts

Executar scripts do npm

bash snippet
1npm run <nome-do-script>
Scripts personalizados definidos no package.json podem ser executados com npm run.

Outros comandos

Inicializar um novo projeto npm

bash snippet
1npm init
2# Usar os valores padrão
3npm init -y

Auditar dependências em busca de vulnerabilidades

bash snippet
1npm audit
2# Corrigir automaticamente os problemas compatíveis
3npm audit fix