Pular para o conteúdo principal
Versão: Next

pnpm add <pkg>

Instala um pacote e todos os outros pacotes dos quais ele depende. Por padrão, qualquer novo pacote é instalado como uma dependência de produção.

TL;DR

ComandoSignificado
pnpm add saxSalva em dependencies
pnpm add -D saxSava em devDependencies
pnpm add -O saxSalva em optionalDependencies
pnpm add -g saxInstalar pacote globalmente
pnpm add sax@nextInstalar a partir da tag next
pnpm add sax@3.0.0Especifica a versão 3.0.0

Locais de pacotes suportados

Instala do registro do npm

pnpm add package-name vai instalar a última versão do package-name usando o registro do npm por padrão.

Se for executado de um workspace, o comando verificará se algum outro projeto do workspace utiliza o pacote especificado. Se sim, uma versão já usada será instalada.

Você também pode instalar pacotes por:

  • tag: pnpm add express@nightly
  • versão: pnpm add express@1.0.0
  • intervalo de versão: pnpm add express@2 react@">=0.1.0 <0.2.0"

Instalar a partir do workspace

Observe que ao adicionar dependências e usar um workspace, pacotes vão ser instalados a partir das fontes configuradas no workspace, dependendo se link-workspace-packages esta ou não definido e do uso do protocolo de espaço do workspace.

Instalar de um sistema de arquivos local

Existem duas maneiras de instalar pelo sistema de arquivos local:

  1. usando um arquivo tarball (.tar, .tar.gz, or .tgz)
  2. de um diretório

Exemplos:

pnpm add ./package.tar.gz
pnpm add ./some-directory

Quando você instala a partir de um diretório, um link simbólico será criado no node_modules do projeto atual. Então é o mesmo que executar pnpm link.

Instalar a partir de um arquivo tarball remoto

O argumento deve começar com um URL buscável começando com "http://" ou "https://".

Exemplo:

pnpm add https://github.com/indexzero/forever/tarball/v0.5.6

Instalar de um repositório Git

pnpm add <git remote url>

Instalar o pacote hospedado em um provedor git, clonando-o com Git. Você pode usar um protocolo para certos provedores Git. Por exemplo, pnpm add github:user/repo

Você pode instalar a partir do Git por:

  • ultimo commit na master: pnpm add kevva/is-positive
  • commit: pnpm add kevva/is-positive#97edff6f525f192a3f83cea1944765f769ae2678
  • branch: pnpm add kevva/is-positive#master
  • intervalo de versão: pnpm add kevva/is-positive#semver:^2.0.0

You may also install just a subdirectory from a Git-hosted monorepo. Por exemplo:

pnpm add myorg/repo#path:packages/foo

It is possible to combine multiple parameters by separating them with &. For instance, you can extend the above command by specifying which branch to fetch from:

pnpm add myorg/repo#path:packages/foo&next

Opções

--save-prod, -P

Instale os pacotes especificados em dependencies como uma dependência comum.

--save-dev, -D

Instale os pacotes especificados em devDependencies como uma dependência de desenvolvimento.

--save-optional, -O

Instala os pacotes especificados em optionalDependencies como dependências opcionais.

--save-exact, -E

Dependências instaladas serão configuradas para usar uma versão exata em vez de usar o intervalo de versões padrão do pnpm.

--save-peer

Usar --save-peer adicionará um ou mais pacotes a peerDependencies e instalará-os como dependências de desenvolvimento.

--ignore-workspace-root-check

Adicionar uma nova dependência ao diretório raiz do workspace falhe, ao menos o --ignore-workspace-root-check ou -w flag seja usado.

Por exemplo, pnpm add debug -W.

--global, -g

Instala um pacote globalmente.

--workspace

Adiciona a nova dependência apenas se ela for encontrada no workspace.

--filter <package_selector>

Leia mais sobre filtragem.