前端包管理工具
2026/10/31约 1257 字大约 4 分钟
npm、cnpm、yarn、pnpm、bun 该用哪个,取决于你在意的是安装速度、磁盘占用、依赖提升带来的幽灵依赖,还是生态兼容。
结论:新项目用 pnpm;需要与老工具链对齐时用 npm;bun 适合本地跑脚本,生产上还得看团队接受度。
五家对比
| 维度 | npm | cnpm | yarn | pnpm | bun |
|---|---|---|---|---|---|
| 优点 | 具有丰富的模块生态系统 社区活跃,更新迭代快 官方的默认工具,使用广泛 | 由于镜像源国内,因此安装速度较快 | 稳定性高,下载速度快 可以直接安装特定版本的包 可以并行下载多个包 | 安装速度快,同时占用空间少 可以与npm完全兼容 | 安装速度极快,是目前性能最强的包管理工具之一 内置打包器、转译器和测试运行时,功能一体化 兼容npm包生态,可直接使用npm的配置 占用空间小 |
| 缺点 | 安装依赖速度慢 会有多个版本的包存在 | 镜像源不稳定,容易出现问题 存在部分包安装失败的情况 | 模块生态相比npm较弱 | 相对较新,缺乏历史纪录 存在兼容性问题 | 生态和社区成熟度不如npm/yarn 部分老旧包可能存在兼容性问题 Windows平台支持相对较弱 |
| 可以替代的方案 | yarn、pnpm、bun | taobao、npm、yarn、pnpm | npm、pnpm、bun | npm、yarn、bun | npm、yarn、pnpm |
| 注意事项 | 由于npm在安装依赖过程中可能会出现网络问题,因此注意备份和恢复本地缓存 | 由于cnpm可能存在不稳定性问题,建议在尝试使用之前先备份好本地缓存 | yarn需要配置registry以确保从正确的镜像源下载包 | pnpm需要在使用之前进行正确的配置和安装,避免出现奇怪的兼容性问题 | 适合追求极致性能和一体化工具链的场景;若依赖大量老旧包,建议先测试兼容性 |
常用命令
先装 pnpm 本身:
npm install -g pnpm日常最常用的还是 npm 这一套:
npm init -y # 快速初始化项目(生成package.json)
npm install <package-name> # 安装生产依赖(写入dependencies,简写:npm i <package-name>)
npm install <package-name> -D # 安装开发依赖(写入devDependencies,完整写法:--save-dev)
npm uninstall <package-name> # 卸载依赖(简写:npm un <package-name>)
npm install # 依据package.json和package-lock.json安装依赖(简写:npm i)
npm install <package-name> -g # 全局安装包(简写:npm i <package-name> -g)
npm install --legacy-peer-deps # 兼容模式安装(跳过peer依赖检查,解决版本冲突)
npm run <script-name> # 执行package.json中自定义脚本(如npm run dev)
npm update <package-name> # 更新指定依赖(不加<package-name>则更新所有)
npm cache clean --force # 清空npm缓存(解决安装异常/版本缓存问题)
npm install <package-name>@<version> # 安装指定版本依赖(解决版本兼容问题)
npm outdated # 检查项目中可更新的依赖包
npm audit # 检查依赖安全漏洞(输出漏洞详情及修复建议)
npm audit fix # 自动修复可解决的依赖安全漏洞
npm ls <package-name> # 查看指定依赖的安装版本及依赖树(简写:npm list,--depth=0仅看顶层)
npm view <package-name> # 查看指定包的远程信息(版本、依赖、发布时间等)
npm config get registry # 查看当前npm镜像源(判断是否为国内源)
npm config set registry <registry-url> # 设置npm镜像源(如淘宝源:https://registry.npmmirror.com)
npm uninstall <package-name> -g # 卸载全局安装的包(简写:npm un <package-name> -g)
npm version <type> # 更新项目版本号(type:patch/小版本 minor/次版本 major/主版本)
npm info <package-name> # 查看指定包的详细信息(同npm view,更简洁)pnpm 对照
前面的结论是新项目用 pnpm,日常命令对应关系:
| 用途 | npm | pnpm |
|---|---|---|
| 安装依赖 | npm install | pnpm install |
| 装某个包 | npm i lodash | pnpm add lodash |
| 装开发依赖 | npm i -D vite | pnpm add -D vite |
| 全局安装 | npm i -g pnpm | pnpm add -g xxx |
| 卸载 | npm uninstall lodash | pnpm remove lodash |
| 跑脚本 | npm run dev | pnpm dev(也可以 pnpm run dev) |
| 执行一次性命令 | npx vite | pnpm dlx vite |
| 看依赖树 | npm ls | pnpm list |
| 查过时依赖 | npm outdated | pnpm outdated |
两处行为差异要注意:
node_modules不是平铺的:pnpm 用硬链接 + 符号链接,顶层只放你声明过的依赖,所以「幽灵依赖」(没写进package.json却能 import)会直接报错,这是好事。- 原生模块要允许构建脚本:pnpm 10+ 默认不跑依赖的
postinstall,需要在package.json的pnpm.onlyBuiltDependencies(或pnpm-workspace.yaml的onlyBuiltDependencies)里列出来,否则esbuild、sharp这类包装完不可用。 - 仓库里多个包时用
pnpm-workspace.yaml,pnpm --filter <包名> dev只跑其中一个。