Node.js execFile 报 spawn ENOENT：路径要放对参数位置

项目目录里有一个可执行程序，终端能运行，Node.js 调用 execFile('identifiers', args, [execPath], callback) 却报 spawn identifiers ENOENT。先检查调用签名：第三个位置接收 options 对象，路径数组不会自动设置程序位置或工作目录。

以下针对 Unix 上 Node.js 直接调用外部可执行文件。终端所在目录、Node 服务启动目录和子进程 cwd 可能不同；Windows 批处理文件及 shell 规则需另外判断，不能原样套用。

程序路径、参数和 cwd 分别有各自的位置

execFile 的第一个参数是要执行的文件名称或路径，第二个参数是传给程序的字符串参数数组，第三个参数是 options。其中 cwd 指定子进程的工作目录，必须指向目录，不是可执行文件本身。

仅使用 identifiers 这样的名称时，程序查找依赖相应 PATH。程序放在项目里，不代表这个目录已经进入 PATH；终端能用 ./identifiers 执行，也不等于 Node 用没有斜杠的名称能找到它。

先核对应用实际运行环境中的程序文件和目录，而不是开发机的文件。容器、服务管理器、打包输出或部署路径变化，都可能让原先的项目相对路径不再成立。

使用明确的文件路径与 options 对象

下面是结构示例，toolDirectory 必须替换为实际存在的绝对目录，里面应有名为 identifiers 的可执行程序。--help 是示例参数，使用前仍需确认目标工具的行为：

const { execFile } = require('node:child_process');
const path = require('node:path');

const toolDirectory = '/path/to/tools';
const executable = path.join(toolDirectory, 'identifiers');

execFile(executable, ['--help'], { cwd: toolDirectory },
  (error, stdout, stderr) => {
    if (error) {
      console.error(error.code, error.message);
      return;
    }
    console.log(stdout);
  }
);

绝对文件路径明确了执行目标，cwd 则控制程序启动后如何解释它自身使用的相对文件路径。这两个值可能相同地基于一个目录构造，但职责不同。也可以采用相对于已核对 cwd 的 ./identifiers；不要仅加 ./，却继续依赖一个不确定的启动目录。

文件路径含空格时，传入完整路径字符串，不要像拼 shell 命令那样在字符串里额外加入引号。程序参数仍逐项放进数组，不把“程序名加全部参数”拼成第一个参数。

execFile 默认不通过 shell 执行，因此不会替你展开通配符、重定向或 shell 变量。不要为了绕过路径问题开启 shell，再把用户输入拼进命令。确实需要 shell 行为时，应单独设计输入约束和调用方式。

正确文件路径仍可能遇到不存在的 cwd

ENOENT 不只表示第一个文件名无法找到。Node 的子进程接口在指定 cwd 不存在时，也会报 ENOENT。因此绝对程序路径正确后，还要确认 cwd 在当前部署中存在，且运行身份可以使用这条路径。

没有指定 cwd 时，子进程继承 Node 进程的当前工作目录。它不自动等于源文件所在目录。以项目模块为基础计算路径时，要结合项目使用的模块格式与部署结构明确基础目录，不把启动时的 process.cwd() 当成永不变化的项目根目录。

若必须依赖 PATH 查找，检查实际 options.env 与进程环境。提供 env 时，它不是只添加一个变量的声明：遗漏 PATH 可能改变查找结果，Unix 下会使用默认的 /usr/bin:/bin 查找。按应用约定保留需要的环境项，不把整份环境变量打印到日志。

如果错误变成权限类错误，继续检查程序与父目录的访问和执行权限；不要统一使用 chmod 777。Linux 上的脚本或特殊二进制在文件存在时仍可能因解释器缺失而无法启动，也需要按具体文件格式调查，不能不断修改同一个已经正确的 cwd。

以子进程结果验证修复

变更前保存调用代码与路径配置，通过受控环境核对程序文件、cwd、运行身份和必要环境。先采用目标工具支持的无副作用参数检查启动，再按业务要求验证实际输入与返回结果。

成功标准是预期程序被启动、退出状态和输出符合业务要求，且启动目录改变后仍能按设计定位资源。回调没有 ENOENT，只说明已越过这一类启动失败，不保证外部程序完成了正确工作。

捕获错误后不要无限重试。实际工具可能在失败之前写过文件或提交过外部修改，应按业务完成记录决定是否重跑。回退时恢复调用与路径配置，保留这次调用的状态；代码回退不会撤销已经发生的外部副作用。