如何解决tsc编译与npm install之间的循环依赖问题？

这个问题我之前也碰到过，确实挺头疼的——npm install和tsc的执行顺序卡在这里了。给你几个更优雅的解决方案，按推荐程度排序：

方案一：利用npm的prepare自动编译（最优解） #

npm有个内置的prepare脚本钩子，在执行npm install（包括不带--production的安装）之后、包被打包或发布之前会自动运行。刚好能解决我们的顺序问题：

1. 在你的package.json的scripts里添加这个钩子：

{
  "scripts": {
    "prepare": "tsc",
    // 其他脚本...
  },
  "bin": {
    "foo": "dist/cli.js"
  }
}

2. 确保typescript和其他编译依赖都放在devDependencies里（正常情况下应该已经是这样了）。

为什么这招管用？ #

当你在CI环境执行npm install时，流程会变成：

• 第一步：安装所有依赖（包括devDependencies里的typescript）
• 第二步：自动触发prepare脚本，执行tsc编译src到dist
• 此时dist/cli.js已经存在，npm能正常识别bin字段的配置，不会报错

本地开发时这也同样好用，每次install依赖后都会自动更新编译产物，不用手动跑tsc。

方案二：临时让bin指向TS源文件（适合开发/快速验证） #

如果只是想在开发阶段跳过编译直接运行，或者CI环境需要临时执行CLI，你可以调整bin指向TS源文件，用ts-node直接运行：

1. 在package.json里修改bin字段，并添加ts-node到devDependencies：

{
  "bin": {
    "foo": "src/cli.ts"
  },
  "devDependencies": {
    "ts-node": "^10.9.1",
    "typescript": "^5.0.0"
    // 其他依赖...
  }
}

2. 在src/cli.ts的最顶部添加shebang，让系统知道用ts-node执行：

#!/usr/bin/env ts-node

// 你的CLI代码...

注意事项 #

这个方案更适合开发场景，生产环境还是建议编译成JS再发布。如果CI里需要用这个方式，记得不要加--production参数安装依赖，否则ts-node会被跳过。

方案三：自定义CI专用脚本（简化你的临时方案） #

如果不想用prepare钩子，也可以把你的临时方案封装成npm脚本，让CI执行更简洁：

在package.json里添加：

{
  "scripts": {
    "build": "tsc",
    "ci:setup": "npm install && npm run build"
    // 其他脚本...
  }
}

然后CI环境直接执行npm run ci:setup就行，本质和你之前的思路一样，但把命令整合到了npm脚本里，维护和执行都更方便。

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