pnpm 命令速查

安装 package.json 中声明的全部依赖，并按需更新 lockfile。

--frozen-lockfile（本仓库 CI 默认）；--prod；--offline；--ignore-scripts；--shamefully-hoist；--strict-peer-dependencies=false；--prefer-offline

添加一个运行时依赖并写入 package.json。

-D / --save-dev；-E / --save-exact；-O / --save-optional；-P / --save-prod；-g 全局；--workspace-root 安装到工作区根

全局安装一个工具（如 TypeScript、ESLint、tsx），加入 PATH。

-g；--global-prefix；--reporter append|ndjson

从项目与 lockfile 中移除一个依赖。

-D 从 devDependencies 中移除；-g 从全局移除；--filter 仅从某个工作区中移除

在 semver 范围内更新依赖；-L / --latest 升级到最新版本。

-L / --latest；-i / --interactive；--workspace-root；--filter

展示过期包及其 current / wanted / latest 版本。

--long；--recursive / -r；--filter

列出已安装的包及其依赖关系树。

--depth 0 仅直接依赖；--prod / --dev；-r 递归；--json | jq

对 lockfile 执行 npm 风格的安全公告检查。

--prod 仅生产；--json

在可行的情况下将依赖提升到同一版本，从而裁剪 lockfile 与依赖树。

--check；--strict-peer-dependencies=false

重新构建 native 依赖（Node 版本升级后或包发布后）。

--reporter；--recursive；--filter

为 native 包（如 esbuild、sharp、@swc/core）批准其 build 脚本。

交互式提示；也可在 package.json#pnpm.onlyBuiltDependencies 中设置

将已有的 package-lock.json / yarn.lock 导入到 pnpm-lock.yaml。

import；无其他参数

执行 package.json#scripts 中定义的脚本。

-r / --recursive 对所有包运行；--filter / -F 仅针对某个包；--parallel；--no-color

从 registry 拉取一个包并直接运行其二进制，无需永久安装。

dlx pkg args；--package 额外包；--silent

在项目上下文中执行命令（PATH 已包含 .node_modules/.bin）。

exec ...；--filter 目标工作区；--recursive；--parallel

基于 create-* 风格的包脚手架化一个新项目。

create [name] [args]；-y / --yes

递归——对工作区中的每个包执行 pnpm 操作。

-r run build；--parallel；--topology 拓扑排序；--order

按包名、目录、glob 或相对路径定位单个包。

--filter pkg | --filter ./packages/foo | --filter {pkg} 仅严格匹配包名；-F 别名

在工作区根添加一个提升的、可被所有包共用的 dev 依赖。

-w / --workspace-root；-D 加入 devDependencies

打印 pnpm 内容寻址 store 的位置（跨项目去重）。

store path；--virtual-store-dir DIR

从 store 中移除不再被引用的包（节省磁盘空间）。

store prune；--force 跳过确认

列出或删除 pnpm 元数据缓存中的条目。

cache list；cache delete <pkg>@<ver>；--registry

读写用户级 / 全局 / store / 项目级的 pnpm 配置。

config get key；config set key val；--location project|user|global

列出所有生效的配置项，或删除某一项。

config list --location project；config delete key

解释一个包为何出现在 node_modules 中——显示其依赖链。

--prod；--dev；-r；--filter

将本地包符号链接到当前项目，或将全局包安装到本地。

link（基于 ./）；link --global <pkg>；--dir

将当前包发布到配置的 registry。

--dry-run；--tag alpha|beta|next；--access public|restricted；--otp N；--filter

生成包的 tarball 但不发布（用于上传到其他渠道）。

--pack-gzip-level 0..9；--pack-destination DIR

一次性查看整个工作区的依赖树。

只在某一个工作区中执行脚本——适合细粒度的 CI 场景。

--filter 配合 dependencies/dependents；--parallel

本仓库的辅助脚本——同步工具翻译到 Nuxt 应用，然后构建工具产物。