Resumo : neste tutorial, você aprenderá sobre o npm e como usar a CLI do npm para instalar novos pacotes.
Introdução ao npm
Npm significa Node Package Manager . _ É um gerenciador de pacotes para a plataforma Node JavaScript.
O Npm é conhecido como o maior registro de software do mundo. Desenvolvedores de código aberto em todo o mundo usam o npm para publicar e compartilhar seu código-fonte.
Npm consiste em três componentes:
- O site permite que você encontre pacotes de terceiros, configure perfis e gerencie seus pacotes.
- A interface de linha de comando ou CLI npm que é executada a partir de um terminal para permitir que você interaja com o npm.
- O registro é um grande banco de dados público de código JavaScript.
Para encontrar a CLI npm em seu computador, execute o npm
comando em um terminal:
npm
Linguagem de código: JavaScript ( javascript )
Por exemplo, o comando a seguir exibirá a versão atual do npm em seu sistema:
npm -v
Linguagem de código: JavaScript ( javascript )
O que você pode fazer com npm?
npm permite que você instale um novo pacote do registro. Isso é o que você fará na maioria das vezes com o npm.
Além disso, o npm permite descobrir e publicar seus novos pacotes de nós.
pacote.json
Em geral, todo projeto npm possui um arquivo chamado package.json
localizado no diretório raiz. É package.json
um arquivo de texto simples que contém informações importantes que o npm usa para identificar o projeto e lidar com dependências.
Para criar o package.json
arquivo, você vai até o diretório raiz do projeto e executa o seguinte comando:
npm init
Linguagem de código: JavaScript ( javascript )
Ao executar o npm init
comando, ele solicitará as informações do projeto, incluindo:
- Nome do pacote
- Versão
- Comando de teste
- Repositório Git
- Palavras-chave
- Autor
- Licença
Se você pressionar Return
ou Enter
, ele aceitará os valores padrão e passará para o próximo prompt.
Se quiser usar opções padrão, use o seguinte comando:
npm init --yes
Linguagem de código: JavaScript ( javascript )
Posteriormente, você poderá alterar os valores padrão no arquivo package.json
.
Instale um novo pacote
Para instalar um novo pacote, você usa o seguinte npm install
comando:
npm install <package_name>
Linguagem de código: JavaScript ( javascript )
Neste comando, você coloca o nome do pacote após as npm install
palavras-chave.
Para encontrar pacotes, você acessa o site do npm e os procura.
Por exemplo, se quiser instalar o express
pacote, você pode executar o seguinte comando:
npm install express
Linguagem de código: JavaScript ( javascript )
Observe que express
é uma estrutura web rápida para Node.
Assim que a instalação for concluída, você verá um novo diretório chamado /node_modules
criado na raiz do projeto. Todos os novos módulos que você instalar serão colocados neste diretório.
Se você expandir o /node_modules
diretório, verá que o npm instalou não apenas express
as dependências do express
, as dependências dessas dependências e assim por diante.
Se você abrir o package.json
arquivo na raiz do projeto, também descobrirá que a dependencies
seção está atualizada, que inclui o express
pacote assim:
"dependencies": {
"express": "^4.17.1"
}
Linguagem de código: JavaScript ( javascript )
Em geral, qualquer novo pacote instalado será listado na dependencies
seção. Neste exemplo, as dependências incluem o express
pacote com versão 4.17.1. Observe que o Npm segue a especificação de versionamento semântico .
Para economizar digitação, você pode usar uma versão mais curta do npm install
comando:
npm i <package_name>
Linguagem de código: JavaScript ( javascript )
Neste comando, i
significa install
.
Instale um pacote como uma dependência de desenvolvimento
Às vezes, você pode querer instalar um pacote que roda apenas no ambiente de desenvolvimento.
Por exemplo, você pode querer instalar um pacote que registre solicitações HTTP, como o morgan
pacote.
Para fazer isso, você usa o npm install
comando com a --save-dev
opção com a seguinte sintaxe:
npm install <package_name> --save-dev
Linguagem de código: JavaScript ( javascript )
Por exemplo:
npm install morgan --save-dev
Linguagem de código: JavaScript ( javascript )
Este comando irá baixar e instalar o morgan
pacote. Além disso, adiciona uma nova seção ao package.json
arquivo chamada devDependencies
assim:
"devDependencies": {
"morgan": "^1.10.0"
}
Linguagem de código: JavaScript ( javascript )
Basicamente, o devDependencies
deve conter pacotes que você usa durante o desenvolvimento. Esses pacotes são necessários apenas enquanto você desenvolve seu aplicativo.
Por outro lado, dependencies
deve conter pacotes dos quais sua aplicação dependerá. Em outras palavras, sem esses dependencies
pacotes sua aplicação não funcionará.
Além disso, você pode executar o npm install
comando para baixar e instalar todos os pacotes listados na seção dependencies
e devDependencies
:
npm install
Linguagem de código: JavaScript ( javascript )
Instale um pacote globalmente em seu sistema
Para instalar um pacote globalmente em seu sistema, use o seguinte comando:
npm install <package_name> --global
Linguagem de código: JavaScript ( javascript )
Ou resumindo:
npm i <package_name> -g
Linguagem de código: JavaScript ( javascript )
Geralmente, você instala um pacote globalmente quando deseja usá-lo em sua linha de comando ou shell.
Se você deseja um pacote que incluirá em seu aplicativo, você deve instalá-lo localmente.
Resumo
- Npm é o gerenciador de pacotes da plataforma Node JavaScript.
- Use
npm install <package_name>
para instalar um novo pacote. - Use
npm install <package_name> --save-dev
para instalar um novo pacote como uma dependência de desenvolvimento. - Use
npm install <package_name> -g
para instalar um pacote globalmente.