自行发布的npm包全局安装后无法识别命令如何解决

你遇到的两个问题都是配置缺失/不匹配导致的，和代码逻辑本身无关，逐一修复即可：

1. 全局安装后提示command not found、npx报找不到可执行文件 #

核心原因：漏配package.json的bin字段，且入口文件缺少shebang声明

• 你之前配置的main字段仅用于声明包被作为依赖引入时的入口文件，和命令行全局调用完全无关。npm全局安装时，只会读取bin字段的配置，将声明的可执行文件软链到系统PATH目录（你的macOS环境下对应/usr/local/bin），未配置该字段时npm不会生成任何全局命令软链，自然会出现命令不存在的报错。
• 修复步骤：
  1. 在package.json中新增bin字段，将命令名和对应的入口文件映射好：

  {
    "bin": {
      "khutzpa": "./index.js"
    }
  }
  

  2. 在index.js文件的最顶部添加shebang行，告诉系统用Node.js解释执行该脚本：

  #!/usr/bin/env node
  

  3. 本地测试可在包根目录执行npm link，将当前本地包软链到全局npm目录，验证khutzpa命令可正常识别后，重新发布包即可。

2. require引入包时需要调用.default才能正常执行 #

核心原因：模块导出规范不匹配

• 你当前使用的是ES Module规范的export default语法导出方法，但包未声明为ES Module类型，CommonJS的require()引入时会自动将ES Module导出内容包装为一个对象，原默认导出的方法会被挂载到对象的default属性上，必须通过.default才能访问。
• 修复方案二选一即可：
  • 方案1（推荐，适配现有CommonJS生态）：将index.js中的export default khutzpa替换为CommonJS规范的导出写法module.exports = khutzpa，无需其他额外配置，用户require('khutzpa')后可直接调用。
  • 方案2：保留ES Module写法，在package.json中新增"type": "module"声明，注意此时原有的if (require.main === module)命令行调用判断逻辑需要同步改为ES Module适配写法，通过import.meta.url与process.argv[1]对比判断是否为直接命令行调用。

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