npm包bin可执行文件创建后无法运行，求排查遗漏点

针对你遇到的问题，除了清理缓存外，还需要检查以下几个容易遗漏的配置点：

• TypeScript编译保留shebang配置
  TS编译器默认会移除文件开头的#!/usr/bin/env node注释，你需要在tsconfig.json的compilerOptions里显式开启保留：

  {
    "compilerOptions": {
      "shebang": true,
      // 其他配置...
    }
  }
  

  这个选项专门控制是否保留执行文件的shebang头，是解决shebang丢失的核心配置。

• bin字段指向编译后的JS文件
  务必确保package.json的bin字段指向编译完成的JavaScript文件，而非TypeScript源文件。比如源码是src/cli.ts，编译后输出到dist/cli.js，则bin配置应为：

  {
    "bin": {
      "my-exe": "./dist/cli.js"
    }
  }
  

  如果指向TS文件，npm无法直接执行，会导致命令失效。

• 本地测试的正确命令
  npm my-exe是调用npm的全局内置命令，本地安装的包的可执行命令需要用npx my-exe来调用，或者在测试项目的package.json的scripts中添加：

  {
    "scripts": {
      "my-exe": "my-exe"
    }
  }
  

  之后执行npm run my-exe来运行命令。

• 打包时包含必要文件
  如果使用npm pack打包，需要在package.json的files字段中包含编译后的输出目录（比如dist/），确保打包后的tar包中包含可执行文件：

  {
    "files": [
      "dist/"
    ]
  }
  

  否则安装后node_modules/.bin的软链接会指向不存在的文件，导致命令报错。

• 可执行权限检查
  确保编译后的JS文件拥有可执行权限，虽然npm在安装时会自动处理，但如果是手动复制文件或编译工具未设置权限，可以手动执行：

  chmod +x dist/cli.js
  

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