pnpm 命令大全修订版本明细

源

采纳

编辑于 5月前

半兽人

pnpm 命令大全

pnpm npm

以下是 pnpm（10.6.2 版）的常用命令，适用于 macOS/Linux/Windows，帮助你高效管理项目和依赖。

1. 基础命令

安装依赖：

pnpm install  # 或 pnpm i，安装 package.json 中的所有依赖

添加依赖：

pnpm add <package>  # 安装并添加到 dependencies
pnpm add -D <package>  # 开发依赖（devDependencies）
pnpm add -g <package>  # 全局安装

移除依赖：

pnpm remove <package>  # 或 pnpm rm，移除依赖

运行脚本：

pnpm run <script>  # 执行 package.json 中的脚本

2. 项目管理

初始化项目：
```
pnpm init  # 创建 package.json
```

更新依赖：

pnpm update  # 或 pnpm up，更新所有依赖到最新兼容版
pnpm update <package>  # 更新特定包

列出依赖：

pnpm list  # 或 pnpm ls，列出当前项目依赖
pnpm list -g  # 列出全局依赖

3. 缓存管理

缓存位置：
- 默认：~/.pnpm-store（macOS/Linux）或 %USERPROFILE%\.pnpm-store（Windows）

查找存储路径：

pnpm store path  # 显示当前缓存路径

检查缓存状态：

pnpm store status  # 检查缓存是否损坏

清理未用缓存：

pnpm store prune  # 删除未被引用的缓存

查看缓存内容：

ls -la "$(pnpm store path)"  # macOS/Linux
dir "$(pnpm store path)"     # Windows (PowerShell)

彻底清理缓存：

rm -rf "$(pnpm store path)"  # macOS/Linux
rmdir /s "$(pnpm store path)" # Windows (CMD)

4. 配置管理

查看配置：

pnpm config get <key>  # 查看某项配置，如 store-dir

设置配置：

pnpm config set <key> <value>  # 设置配置
# 示例：
pnpm config set store-dir ~/.pnpm-store  # 指定缓存路径
pnpm config set registry https://registry.npmjs.org/  # 设置镜像

重置环境：

pnpm setup  # 初始化或修复 pnpm 配置

5. 其他实用命令

查看版本：

pnpm --version  # 或 pnpm -v，显示 pnpm 版本

强制重新安装：

pnpm install --force  # 忽略缓存，重新安装

执行特定版本工具：

pnpm exec <command>  # 在项目环境下运行命令
# 示例：
pnpm exec node --version

多项目管理（monorepo）：

pnpm -r <command>  # 对所有子项目运行命令
# 示例：
pnpm -r build  # 构建所有子项目

6. 注意事项

权限修复（如缓存目录不可写）：

sudo chmod -R u+rw "$(pnpm store path)"  # macOS/Linux

网络问题（下载失败时）：

pnpm config set registry https://registry.npmjs.org/  # 切换官方镜像

与 npm 的兼容性：大多数 npm 命令可以用 pnpm 替代（如 npm install -> pnpm install）。

示例：快速上手

pnpm init                    # 创建新项目
pnpm add @heroicons/react    # 安装依赖
pnpm store path              # 检查缓存位置
pnpm run dev                 # 运行开发脚本
pnpm store prune             # 清理无用缓存

预览