package-management

用途：为项目统一包管理与依赖版本。项目使用 pnpm，并由 corepack 自动管理 pnpm 版本；pnpm 版本在 package.json 的 packageManager 字段中声明，例如 {"packageManager": "pnpm@9.1.0"}，运行 pnpm 命令时 corepack 会确保使用该精确版本，无需手动安装 pnpm。主要能力与用法：安装全部依赖用 pnpm install；新增生产依赖用 pnpm add <package-name>，开发依赖用 pnpm add -D <package-name>；升级 pnpm 到最新版用 corepack use pnpm@latest（会同步更新 package.json 的 packageManager 字段），或指定版本 corepack use pnpm@9.5.0。其他常用命令包括 pnpm update --latest、pnpm update --interactive --latest、pnpm outdated、pnpm dedupe。CI/CD 中先 corepack enable，再运行 pnpm install、pnpm build。限制与排查：不要全局安装 pnpm，不要混用 npm 或 yarn，不要手动编辑 packageManager 字段；若出现签名验证错误可运行 npm install -g corepack@latest；若提示 pnpm 找不到，先 corepack enable 再 corepack install；版本不符时检查 packageManager 字段并确保 corepack 已启用；升级 pnpm 后应提交 package.json 变更。首次设置：corepack enable，再 pnpm install，然后 pnpm dev。