构建工具

PNPM 完整技术文档

pnpm 全称：Performant npm（高性能的 npm）

作者：洋柿子·2026-09-01·共 6 篇 · 当前 4

PNPM 完整技术文档

一、什么是 pnpm

pnpm 全称：Performant npm（高性能的 npm）

是 现代 JavaScript 包管理器，用来替代传统的 npm、yarn，管理项目依赖包。

一句话定义：

pnpm 是更快、更省磁盘、更严格、更现代的前端依赖管理工具，现在 Vue / Vite / 开源项目官方首选。

二、为什么会出现 pnpm？（npm /yarn 的痛点）

1. 传统 npm/yarn 最大问题

  1. 磁盘极度浪费

    每新建一个项目，node_modules 都会完整复制一遍所有依赖

    哪怕是同一个版本的 Vue、Vite，一百个项目就复制一百份。

  2. 安装速度慢

    每次安装都要重新下载、解压、复制文件，项目越多越慢。

  3. node_modules 结构臃肿嵌套太深

    Windows 经常出现路径过长报错，删都删不掉。

  4. 幽灵依赖

    项目 package.json 没声明的包，却能直接导入，线上部署容易报错。

  5. 依赖版本提升混乱

    扁平化依赖容易导致版本莫名错乱。

2. pnpm 诞生目的

解决 npm/yarn 浪费磁盘、安装慢、依赖管理不规范 的所有痛点。

三、pnpm 核心底层原理（关键）

1. 内容寻址存储 CAS + 硬链接

  • pnpm 会把所有包、同一个版本只在全局仓库存唯一一份
  • 新项目安装依赖时不复制文件，只用硬链接指向全局仓库
  • 一百个项目用 Vue3，磁盘也只存 1 份

2. 软链接重构 node_modules

pnpm 用符号链接组织 node_modules，结构扁平、不嵌套、体积极小。

3. 严格依赖隔离

强制只能导入 package.json 声明过的依赖，彻底杜绝幽灵依赖。

四、pnpm 核心优势

  1. 超级省磁盘

    比 npm 少占用 60%~80% 磁盘空间。

  2. 安装速度极快

    比 npm 快 2~3 倍，比 yarn 快很多，第二次安装几乎瞬间完成。

  3. 天生支持 Monorepo

    Vue3、Vite、Pinia 源码全是用 pnpm Monorepo 管理多包项目。

  4. 更严格依赖管理

    禁止幽灵依赖，项目依赖更稳定、可部署性更强。

  5. 完全兼容 npm 语法

    命令几乎和 npm 一模一样，上手零成本。

  6. 内置缓存、离线安装

    装过一次，没网也能直接安装。

  7. 自动兼容 npm lock /yarn lock

    可以无缝迁移旧项目。

五、npm /yarn/pnpm 硬核对比

表格

特性 npm yarn pnpm
磁盘占用 极高（重复复制） 高 极低（全局一份共享）
安装速度 慢 中等 极快
node_modules 结构 嵌套臃肿 扁平化 链接式、超轻量
幽灵依赖 存在 存在 杜绝
Monorepo 支持 弱 一般 原生完美支持
缓存机制 一般 有 超强全局缓存
现代项目推荐 老旧项目 老项目 Vue/Vite 新项目标配

六、安装 pnpm

全局安装（推荐）

bash

运行

# Windows / Mac / Linux 通用
npm install -g pnpm

装完校验：

bash

运行

pnpm -v

七、pnpm 常用命令（和 npm 对照）

表格

作用 npm 命令 pnpm 命令
初始化项目 npm init -y pnpm init -y
安装所有依赖 npm install pnpm install / pnpm i
安装生产依赖 npm i 包名 pnpm add 包名
安装开发依赖 npm i -D 包名 pnpm add -D 包名
卸载依赖 npm uninstall 包名 pnpm remove 包名
运行脚本 npm run dev pnpm dev
全局安装 npm i -g 包名 pnpm add -g 包名
查看已安装包 npm list pnpm ls

重点：pnpm 可以直接简写脚本，不用写 run

pnpm dev 等价 npm run dev

八、Vite / Vue 项目用 pnpm

现在创建 Vite 官方默认推荐 pnpm：

bash

运行

pnpm create vite

安装依赖：

bash

运行

pnpm install

运行项目：

bash

运行

pnpm dev

打包：

bash

运行

pnpm build

完全无缝适配 Vue3 + Vite + SCSS + Pinia 所有生态。

九、什么时候必须用 pnpm？

  1. 新建 Vue / Vite 项目（现在行业标配）
  2. 磁盘空间小、项目多（前端项目一多，pnpm 优势爆炸）
  3. 学习源码：Vue3、Vite、Pinia、Element Plus 全用 pnpm
  4. 做 Monorepo 多包项目
  5. 嫌弃 npm 安装慢、node_modules 太大

十、总结一句话

pnpm = 更快 + 更省磁盘 + 更规范 + 现代前端项目标配

现在学 Vue/Vite，直接放弃 npm，全程用 pnpm 就行。

需要我给你一份 pnpm 从 npm 迁移项目完整步骤（删除旧依赖、换镜像、配置国内源）吗？

← 返回课程首页