查看版本#

1
node -v
2
pnpm -v
3
corepack --version

项目 README 或 package.json 里如果写了 engines，要优先按项目要求来。

使用 lockfile 安装#

1
pnpm install --frozen-lockfile

服务器部署时建议使用 frozen lockfile，避免自动改依赖版本导致构建结果不可控。

常见构建失败原因#

• Node 版本低，不支持依赖使用的新语法。

• pnpm 版本差异导致依赖解析不同。

• lockfile 和 package.json 不一致。

• 服务器内存或磁盘不足。

记录部署环境#

每次成功部署后，可以记录 Node、pnpm、构建命令和构建耗时。以后出问题时，有一个可对比的基线。

实战复盘#

使用《Node 与 pnpm 版本检查》时，我会先确认环境边界：本地还是服务器，Windows 还是 Linux，开发环境还是线上环境。很多命令本身没错，但换了系统或权限就会得到完全不同的结果。

修复后不要只看报错消失，还要做业务层验证。比如端口释放后服务是否重新启动，缓存清理后页面是否显示新内容，pip 安装后目标环境是否真的能 import。

排查记录的质量取决于可复现性。只要别人能按文章从现象走到验证，这篇文章就不是临时笔记，而是一张可靠的操作卡片。

最小验收样例#

验收《Node 与 pnpm 版本检查》时，我会保留一条修复前命令和一条修复后命令。前者证明问题存在，后者证明问题已经消失，而不是只凭浏览器或终端感觉判断。

如果这篇文章涉及服务器操作，还要记录当前路径、用户、服务名和关键配置文件。排查记录越能还原现场，下次遇到同类问题越不需要重新摸索。

小结#

Node 和 pnpm 版本是前端部署的地基。先确认运行时和 lockfile，再追代码问题，排查会更快。