PNPM使用脱字符(^)为何不更新小版本？如何解决？

原因 #

PNPM 的版本解析逻辑和 npm 存在差异：

• 当项目中存在 pnpm-lock.yaml 锁文件时，PNPM 会严格沿用锁文件里记录的版本，不会主动升级到 ^ 符号指定范围内的最新小版本，只会在安装时提示有可用更新。
• 而 npm 在无锁文件时会直接拉取范围内的最新版，有锁文件时同样不会自动更新，也需要手动操作。本质上 PNPM 是支持脱字符版本规则的，只是锁文件的存在限制了自动升级行为。

解决方法 #

• 首次安装（无锁文件）：直接执行 pnpm install，PNPM 会自动安装 ^4.13.5 范围内的最新小版本（即4.29.5）。
• 已有锁文件需更新：执行命令 pnpm update @tanstack/react-query，该命令会将依赖升级到脱字符范围内的最新版本，同时更新 pnpm-lock.yaml。
• 强制重新拉取最新版：删除项目根目录的 pnpm-lock.yaml 文件后，执行 pnpm install，即可重新安装范围内的最新版本。不过锁文件的作用是保证团队依赖版本一致，除非必要不建议频繁这么做。

内容的提问来源于stack exchange，提问作者Zenexis