这个问题我之前在集成Cloudflare Pages和Fauna DB时也碰到过，核心原因是npm脚本无法定位到本地安装的worktop可执行文件，给你几个实用的排查和解决方向：

1. 确保worktop正确安装为本地开发依赖 #

首先确认worktop是装在项目的devDependencies里的，因为build脚本属于开发阶段的操作，运行以下命令重新安装：

npm install worktop --save-dev

安装完成后检查package.json里是否出现worktop的条目，同时查看node_modules/.bin目录下是否生成了worktop的可执行文件链接。

2. 用npx调用本地worktop命令 #

最直接的解决方法是修改package.json里的build脚本，通过npx来指定调用本地node_modules中的worktop：

{
  "scripts": {
    "build": "npx worktop build index.js"
  }
}

npx会自动在项目的node_modules/.bin目录中查找对应的命令，避开全局路径的问题，这也是最推荐的方式。

3. 排查全局安装的路径问题 #

如果你尝试过全局安装worktop但依然无效，可能是全局npm的bin目录不在系统的PATH环境变量中：

• 先运行which worktop（mac/Linux）或where worktop（Windows），如果没有输出路径，说明全局安装的命令没被系统识别。
• 找到npm全局bin目录的位置（mac通常是~/npm/bin，Windows是C:\Users\<你的用户名>\AppData\Roaming\npm），将其添加到系统PATH中，然后重启终端再试。

4. 尝试指定worktop版本安装 #

有时候新版本的worktop可能存在兼容性问题，你可以尝试安装一个稳定版本来测试：

npm install worktop@0.8.0 --save-dev

这个版本是很多教程中常用的稳定版，大概率能适配你的场景。

补充：npm脚本默认会优先查找node_modules/.bin下的命令，但如果依赖安装过程中缓存出错或者链接未生成，就会出现找不到命令的情况，用npx或者重新安装依赖基本能解决90%以上的这类问题。

内容的提问来源于stack exchange，提问作者Terrabythia