pnpm run pnpm --filter @acme/web dev corepack enable node -v && pnpm -v
新同事 clone 后按 README 跑 pnpm dev,报 ERR_PNPM_NO_SCRIPT Missing script: dev,可老同事本地同样的命令能跑。先别急着动参数,把报错原文和时间点记下来,顺序反了容易白折腾。
原因不复杂,dev 脚本只写在子包里,根 package.json 没有同名入口,pnpm 在根目录找不到就报错。老同事的全局配置或 shell 别名让命令落到了子目录。
「新人启动失败」排查到最后往往是很小的一处差异,前面那些复杂猜测可以先放一放。动手前把原文件复制一份带时间戳,出问题立刻换回去,比现场分析快得多。
一次只改一处,改完立刻验证,几个改动叠在一起,出问题就说不清是谁导致的。先做最小复现,能稳定跑出来的问题,排查成本会低一个数量级。
别只看报错的最后一行,往上看几行,真正的起因通常在上面。
处理上按这个顺序:根 package.json 补一条 dev 脚本 转发到具体包;README 里写清 clone 后要先 pnpm install;加 engines 和 packageManager 字段固定 pnpm 版本;用 corepack enable 让版本自动对齐。
改完只确认一件事:干净目录 clone 后按 README 三条命令能起服务 pnpm dev 不再报 missing script。
