科技 · 实用指南
npm ENOENT：新建 package.json 前先核实失败路径
保存准确错误路径和调用者目录，区分检出文件缺失、项目根、workspace 和启动器问题。本地对照说明，空清单不能修复原项目。
npm 报告 package.json 的 ENOENT 时，先保存它尝试打开的路径。路径组成部分缺失，可能来自目录错误、检出不完整或选中了另一个包；这条消息本身不能替你选择修复方式。
我们在隔离的 Node v24.19.0/npm 11.9.0 环境区分了根脚本、workspace 脚本、已跟踪却缺失的清单和无关空清单，十项检查通过。这些结果说明如何从路径取证，没有复现历史 Windows --prefix 问题，也不保证安装或 CI 构建通过。
保存失败路径与调用者
改文件前复制 code、syscall、path 和完整命令，记录调用者起始目录、Node/npm 版本，以及启动 npm 的 IDE 任务、CI 步骤或服务。保留盘符、容器路径与符号链接上下文；需要分享时，再在副本中缩短或隐藏私人路径信息。
将日志与预期仓库和包对照。npm 脚本运行目录可能不同于最初调用目录：显式 prefix 对照在根包内运行脚本，而 INIT_CWD 仍保留父目录。因此，仅凭脚本的 cwd，不能重建原命令从哪里启动。
新建清单前先核对清单位置
从已确认的仓库根比较受控 package.json 路径、所选提交、实际工作文件与错误路径。在 Git 中，从根运行 git ls-files -- package.json ':(glob)**/package.json' 可列出根与嵌套的受控清单。列出的路径是索引证据，不证明文件现在存在或字节符合预期。
如果当前检出或制品应包含该清单，先保留本地修改，再按项目常规流程恢复目标文件。不要只为压下此次报错就运行 npm init。我们的自制对照移除工作副本后，Git 仍列出 package.json；恢复原始字节后，预期脚本才恢复运行。
选择项目根或真实 workspace
读取根 workspaces 配置与相关子包清单。workspace 选择器可以使用声明包名或路径，最后一级文件夹名称不一定就是包名。npm v11 文档说明，在 workspace 内启动时会选择其上下文，并把 prefix 设为 workspace 根。
对照的根包声明 packages/a，子包清单名称却是 fixture-a。npm run probe --workspace=fixture-a 与进入该子包运行 probe 都选中子包脚本。猜测的 --workspace=a 则返回 No workspaces found，而非 ENOENT。应把新错误保留为另一分支，不要硬套缺文件诊断。
比较调用方式并限定版本范围
用小型、已获授权的复现，比较原启动器与直接进入已核实包、显式 workspace 选择器或原 prefix 路径。输出起始和实际运行目录；工具能提供时，记录解析到的清单。每次只改一种调用方式，比较过程中不要重置缓存或替换清单。
公开 npm issue 7722 记录了特定旧 npm 版本在 Windows 上的 --prefix install 失败，以及 cd 或 ci 的变通反馈。它以 not planned 关闭，不代表所有受影响版本均已修复。我们在 Linux/npm 11.9.0 运行 --prefix project run probe 成功，但这只是脚本对照，不是 Windows npm install、依赖解析或生产回归测试。
只修复已经证明的原因
目录错误就定位预期包；受控文件缺失就修复检出或制品；启动器 cwd 错就明确设置该任务目录；workspace 选择器错误就使用核实的包名或路径。若与工具版本相关，先保留最小复现，再决定有限的版本或变通方案，不要把旧问题的办法套给所有 ENOENT。
空目录与缺失受控文件的对照，均报出准确的 package.json 缺失路径。在空目录写入 {} 后，路径可读了，却报 Missing script: probe，并未恢复原项目脚本或依赖。这个对照说明，一条报错消失远弱于预期项目真正恢复。
要求原工作流通过
回到原启动器，使用预期版本和 workspace 目标，重新执行原 install、ci 或脚本动作。保留调用目录、清单身份、退出状态、预期输出或项目检查。另一个命令成功退出可以作为比较证据，不能自动代表原失败流程已完成。
十项检查只使用 Linux、Node v24.19.0 与 npm 11.9.0 下新建的本地对照，运行受控探针脚本和受控文件检查，没有安装依赖或访问网络。没有复现 Windows、IDE、CI 服务、私人仓库或历史 --prefix 回归。链接的 npm v11 文档标注 Legacy，是特定版本分支，不代表最新 CLI。
