本机 npx create-app 生成的是 src/modules 结构,同事全局装的 cli 生成的是 app/modules,两边互相找不到文件。碰到这种情况,我一般先确认改动有没有真的生效。
原因不复杂,全局安装的是 1.2,npx 拉到的是最新 2.0,两个版本的模板目录不同。命令名一样,版本靠 PATH 顺序决定。
「全局包版本」相关的验证我通常做两遍,改完一次、隔天再看一次,确认不是临时生效。日志级别临时调高可以,记得改回去,长期开着既占磁盘又掩盖真问题。
npx create-app@2.0.1 --version npm ls -g --depth=0 | findstr create-app where create-app
权限不要一口气开到最大,先加到够用再往上试,范围小才好收。把复现步骤压到三条以内,交给同事也能跑出来,才算真的定位清楚。
具体做法是,统一用 npx 并锁定版本 不要依赖全局安装;在 README 里写死生成命令和版本号;生成器启动时打印自己的版本和模板目录;CI 里用同一版本 避免本地和流水线产物不一致。
最后用这个标准收尾,在三个环境里执行同一条 npx 命令 输出的版本号和目录结构完全一致。
