运行ts-node-dev出现ts.resolveTypeReferenceDirective非字符串值报错

该报错的核心触发逻辑是TypeScript 4.7及以上版本调整了内部API ts.resolveTypeReferenceDirective 的方法签名，旧版本的TS生态封装包未同步适配该变更：

• TS 4.7之前，该API只接受字符串格式的类型引用路径作为参数；TS 4.7之后，API支持传入对象格式的引用配置，同时对入参类型做了强校验。
• 你项目中使用的ts-node-dev@2.0.0正式版的内部类型解析逻辑没有适配这个签名变更，在解析@types/xxx格式的类型依赖时，会把对象格式的引用参数直接传给新版TS的API，触发非字符串入参的报错。如果移除所有@types/xxx依赖，解析流程不会走到这个存在兼容问题的逻辑分支，因此项目可以正常运行。
• 另外如果项目依赖树中存在多版本TypeScript实例（比如ts-jest@27.x自带的旧版TS依赖和你手动安装的新版TS混用），会进一步放大这个兼容问题。

按优先级选择以下任意一种方案即可解决问题：

• 方案1：替换ts-node-dev为ts-node原生监听能力（最稳定，无第三方兼容问题）
  ts-node从10.6.0版本开始原生支持文件监听启动，不需要依赖第三方封装的ts-node-dev，直接替换即可：
  1. 卸载旧的ts-node-dev依赖：

     npm uninstall ts-node-dev
     

  2. 修改package.json中的启动脚本，将原命令ts-node-dev ./index.ts替换为：

     ts-node --watch ./index.ts
     

• 方案2：固定TypeScript版本为兼容版
  如果需要继续使用现有ts-node-dev版本，可以将TypeScript版本固定到签名变更前的最后一个稳定版v4.6.4，和旧版解析逻辑完全匹配：
  1. 删除项目下的node_modules目录、包管理锁文件（package-lock.json/yarn.lock/pnpm-lock.yaml）
  2. 重新安装固定版本的TypeScript：

     npm install typescript@4.6.4 -D
     

  3. 执行npm install重新安装全量依赖后启动即可。
• 方案3：统一全项目依赖的TypeScript版本
  执行npm ls typescript命令排查依赖树中所有的TypeScript版本，如果存在低于4.7的旧版本被其他依赖引入，将对应依赖升级到支持TS 4.7+的版本（比如将ts-jest升级到28.0.0以上版本），保证整个项目使用同一个TS版本，避免多实例混用导致的参数传递错误。

内容的提问来源于stack exchange，提问作者Mohamed Anser Ali