使用commander开发Node.js CLI工具时运行自定义命令提示not found如何解决

你遇到的command not found: zone-conf报错，是因为缺失了Node.js CLI工具的全局命令注册相关配置，具体遗漏步骤和修复方法如下： #

核心原因 #

你在代码中定义的zone-conf是程序内部的子命令，不是系统层面可直接识别的全局可执行命令，直接在终端输入zone-conf时系统找不到对应的执行文件，所以会报错。 #

临时测试方法（无需额外配置） #

你可以直接通过node调用入口文件+子命令的方式验证逻辑，执行以下命令即可触发对应action：

node app.js zone-conf generate tx-commands

实现全局zone-conf命令的配置步骤 #

如果要实现直接输入zone-conf就能调用的效果，需要补充以下配置：

• 添加入口文件shebang声明
  在你的app.ts文件第一行添加下面的注释，tsc编译后会保留到输出的app.js中，作用是告诉系统用Node.js执行该文件：

#!/usr/bin/env node
import { Command } from 'commander';
// 剩余原有代码不变

• 配置package.json的bin字段
  在项目的package.json中添加bin配置，指定自定义命令名和对应的入口文件路径：

{
  "name": "你的包名",
  "version": "0.0.1",
  // 其他原有配置
  "bin": {
    "zone-conf": "./app.js"
  }
}

• 注册全局软链接
  在项目根目录执行npm link命令，npm会自动把你在bin中配置的zone-conf命令软链接到系统全局Node.js的可执行目录下，配置完成后你就可以直接在终端执行zone-conf generate tx-commands了。

如果后续要发布到npm供其他用户使用，用户全局安装你的包时会自动完成命令注册，无需手动执行link操作。

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