Saltar al contenido principal
Version: Próxima versión

pnpm add <pkg>

Instalar el paquete y cualquier paquete que dependa de el. Por defecto, cualquier nuevo paquete se instala como una dependencia de producción.

TL;DR

ComandoSignificado
pnpm add saxSe guarda en dependencies
pnpm add -D saxSe guarda en devDependencies
pnpm add -O saxSe guarda en optionalDependencies
pnpm add -g saxInstalar el paquete globalmente
pnpm add sax@nextSe instala desde el tag next
pnpm add sax@3.0.0Especificar versión 3.0.0

Ubicaciones de paquetes soportados

Instalar desde el registro de npm

El comando pnpm add package-name instalará la versión más reciente del paquete package-name desde el registro de npm por defecto.

Si se ejecuta en el workspace, el comando primero intentara verificar si otros proyectos en el workspace usan el paquete especificado. Si es así, se instalará el rango de versión ya previamente instalado.

También puede instalar paquetes con:

  • etiqueta: pnpm add express@nightly
  • versión: pnpm add express@1.0.0
  • rango de versiones: pnpm add express@2 react@">=0.1.0 <0.2.0"

Instalar desde el espacio de trabajo

Tenga en cuenta que al añadir dependencias y trabajar dentro de un espacio de trabajo, los paquetes se instalarán desde las fuentes configuradas, dependiendo de si link-workspace-packages está configurado, y el uso de la opción workspace: range protocol.

Instalar desde el sistema de archivos local

Hay dos formas de instalar desde el sistema de archivos local:

  1. desde un archivo tarball (.tar, .tar.gzo .tgz)
  2. de un directorio

Ejemplos:

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

Cuando se instala desde un directorio, se creará un enlace simbólico en el node_modules del proyecto, por lo que es lo mismo que ejecutar pnpm link.

Instalar desde tarball remoto

El argumento debe ser un URL obtenible que empiece por "http://" o "https://".

Ejemplo:

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

Instalar desde el registro de npm

pnpm add <git remote url>

Instala el paquete desde el proveedor de Git alojado, clonándolo con Git. Puede utilizar un protocolo para determinados proveedores Git. Por ejemplo, pnpm add github:user/repo

Puede instalar desde Git mediante:

  • último commit del master: pnpm add kevva/is-positive
  • commit: pnpm add kevva/is-positive#97edff6f525f192a3f83cea1944765f769ae2678
  • branch: pnpm add kevva/is-positive#master
  • rango de versiones: pnpm add kevva/is-positive#semver:^2.0.0

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

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

Opciones

--save-prod, -P

Instala los paquetes especificados como una dependencia común: dependencies.

--save-dev, -D

Instala los paquetes especificados como devDependencies.

--save-optional, -O

Instala los paquetes especificados como optionalDependencies.

--save-exact, -E

Las dependencias guardadas se configurarán con una versión exacta en lugar de utilizar el operador de rango semver por defecto de pnpm.

--save-peer

El uso de --save-peer agregará uno o más paquetes a peerDependencies y los instalará como dependencias de desarrollo.

--ignore-workspace-root-check

Se produce un error al agregar una nueva dependencia al paquete del espacio de trabajo raíz, a menos que se utilice el parámetro --ignore-workspace-root-check o -w.

Por ejemplo, pnpm add debug -w.

--global, -g

Instala un paquete globalmente.

--workspace

Solo añade la nueva dependencia si se encuentra en el espacio de trabajo.

--filter <selector_de_paquete>

Leer más sobre filtrado.