O Node Package Manager (NPM) é um gerenciador de pacotes que auxilia na instalação e desinstalação de pacotes, assim como no gerenciamento de versões e dependências necessárias para executar aplicações.
Como instalar o NPM
O NPM já vem instalado junto com o Node.js, dessa forma, para instalá-lo basta instalar o Node.js:
curl -sL https://deb.nodesource.com/setup_14.x | sudo -E bash -
sudo apt install -y nodejs
Dica: com o pacote n você pode usar mais de uma versão do Node.js, execute npm install -g n.
Atualizando o NPM
Como o NPM é um pacote do Node.js, podemos usá-lo para fazer a sua própria atualização:
npm install -g npm@latest
As versões disponíveis do Node.js e do NPM podem ser consultadas aqui.
Gerenciando pacotes localmente
Para começar a gerenciar pacotes é necessário criar o arquivo package.json, que será responsável por armazenar informações sobre a aplicação.
Inicializando o projeto
Para criar o arquivo package.json execute o npm init dentro da pasta da aplicação.
Caso não queira informar os dados na criação do arquivo package.json, use o parâmetro -y ou --yes: npm init -y.
Instalando pacotes
Para instalar pacotes, use o comando abaixo:
npm install nome-pacote
Dica: você também pode usar npm i ou npm add.
Se o pacote for uma dependência de desenvolvimento, use o comando:
npm install nome-pacote --save-dev
# ou
npm install nome-pacote -D
Instalando pacotes diretamente do Github
Se for um respositório público use o protocolo HTTPS:
npm install usuario/repositorio#nome-branch
# ou
npm install https://github.com/usuario/repositorio.git
Se for um respositório privado use o protocolo SSH:
npm install git+ssh://git@github.com/usuario/repositorio.git
Para atualizar pacotes do GibHub, desinstale e instale novamente os pacotes com os comandos: npm uninstall e npm install.
Listando pacotes instalados
Para saber quais pacotes estão instalados, execute: npm ls.
O comando npm ls faz uma busca recursiva, trazendo assim, as dependências dos pacotes instalados. Para buscar remover as dependências da busca, execute: npm ls --depth=0.
Listando pacotes desatualizados
Para listar os pacotes desatualizados, execute: npm outdated.
Assim como o comando npm ls, o comando acima faz uma busca recursiva e inclui as dependências dos pacotes instalados. Para contornar isso, execute: npm outdated --depth=0.
Atualizando pacotes
Para atualizar pacotes, execute:
npm update nome-pacote
Dica: você também pode usar npm up ou npm upgrade
Removendo pacotes
Para remover pacotes, execute:
npm uninstall nome-pacote
Gerenciando pacotes globalmente
Além de poder instalar os pacotes localmente, há a possibilidade de instalar os pacotes globalmente.
Pasta de pacotes instalados globalmente
Antes de começar é importante saber em qual pasta no seu computador os pacotes instalados globalmente serão armazenados, dessa forma, execute:
npm config get prefix
Para gerenciar pacotes globais, basta usar o parâmetro -g, por exemplo, para instalar um pacote globalmente, execute: npm install -g nome-pacote.
O parâmetro -g pode ser usado com: