以下是 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 # 清理无用缓存
