pnpm es un gestor de paquetes rápido y eficiente en espacio de disco. Utiliza un almacenamiento direccionable por contenido para desduplicar paquetes en todos los proyectos de una máquina, ahorrando una cantidad significativa de espacio en disco. pnpm aplica por defecto una resolución estricta de dependencias, evitando dependencias fantasma. La configuración debe colocarse preferiblemente en pnpm-workspace.yaml para opciones específicas de pnpm.
Importante: Al trabajar con proyectos pnpm, los agentes deben verificar la existencia de los archivos pnpm-workspace.yaml y .npmrc para entender la estructura del workspace y la configuración. En entornos CI, usa siempre --frozen-lockfile.
Esta habilidad está basada en pnpm 10.x, generada el 2026-01-28.
Núcleo
| Tema | Descripción | Referencia |
|---|---|---|
| Comandos CLI | Instalar, añadir, eliminar, actualizar, ejecutar, exec, dlx y comandos de workspace | core-cli |
| Configuración | pnpm-workspace.yaml, ajustes de .npmrc y campos de package.json | core-config |
| Workspaces | Soporte para monorepos con filtrado, protocolo de workspace y archivo de bloqueo compartido | core-workspaces |
| Store | Almacenamiento direccionable por contenido, enlaces duros y eficiencia de disco | core-store |
Funcionalidades
| Tema | Descripción | Referencia |
|---|---|---|
| Catálogos | Gestión centralizada de versiones de dependencias para workspaces | features-catalogs |
| Anulaciones | Forzar versiones específicas de dependencias, incluidas las transitivas | features-overrides |
| Parches | Modificar paquetes de terceros con correcciones personalizadas | features-patches |
| Alias | Instalar paquetes con nombres personalizados usando el protocolo npm: | features-aliases |
| Hooks | Personalizar la resolución con hooks de .pnpmfile.cjs | features-hooks |
| Dependencias Pares | Instalación automática, modo estricto y reglas de dependencias | features-peer-deps |
Mejores Prácticas
| Tema | Descripción | Referencia |
|---|---|---|
| Configuración CI/CD | GitHub Actions, GitLab CI, Docker y estrategias de caché | best-practices-ci |
| Migración | Migrar desde npm/Yarn, manejar dependencias fantasma, migración de monorepos | best-practices-migration |
| Rendimiento | Optimizaciones de instalación, caché del store, paralelización de workspaces | best-practices-performance |