tsc可解析模块但ts-node运行oclif CLI时提示找不到TypeScript模块

这个问题的核心矛盾其实很好理解：tsc --traceResolution能找到模块是因为它严格遵循你tsconfig.json里的baseUrl配置，但ts-node在配合OCLIF运行时，并没有正确继承TypeScript的路径解析规则——要么是ts-node没加载完整的tsconfig配置，要么是OCLIF的加载流程直接用了Node.js原生的require，而Node.js本身根本不认识TypeScript的baseUrl路径映射。

下面给你几个具体的解决方向，按优先级排序：

1. 先修正导入语法并补全tsconfig路径配置 #

你当前用的是CommonJS的require语法，结合TypeScript的模块系统，建议先统一成ES模块导入风格：

// 替换原来的require写法
import { MyClass } from 'my-module';

同时在tsconfig.json的compilerOptions里显式添加paths配置，强化路径映射规则：

{
  "compilerOptions": {
    // ...你的其他配置
    "baseUrl": "src",
    "paths": {
      "*": ["*"] // 把所有绝对路径模块映射到src目录下的对应文件
    }
  }
}

这一步能确保tsc编译时生成正确的相对路径代码，也能让ts-node更清晰地识别路径规则。

2. 让ts-node正确识别tsconfig的路径配置 #

ts-node默认可能不会全局应用tsconfig的路径规则，尤其是在OCLIF的上下文里。你可以通过两种方式解决：

• 方式一：启动时显式指定tsconfig并加载路径注册器
  先安装tsconfig-paths（用来把TypeScript的路径映射转成Node.js能识别的规则）：

  npm install -D tsconfig-paths
  

  然后修改你的启动命令：

  ts-node -r tsconfig-paths/register --project ./tsconfig.json src/commands/create/index.ts
  

• 方式二：在OCLIF配置中直接注入tsnode参数
  在项目根目录的package.json里，给oclif配置添加tsnode字段：

  {
    "oclif": {
      "commands": "./lib/commands",
      "bin": "cli",
      "devPlugins": ["@oclif/plugin-help"],
      "tsnode": {
        "require": ["tsconfig-paths/register"],
        "project": "./tsconfig.json"
      }
    }
  }
  

  这样OCLIF在启动ts-node时会自动加载路径规则，不用每次手动加参数。

3. 临时验证方案：设置NODE_PATH（不推荐长期使用） #

如果你只是想快速验证路径是否正确，可以临时设置NODE_PATH环境变量，让Node.js原生的require能找到src目录：

NODE_PATH=./src ts-node src/commands/create/index.ts

不过这个方案不推荐长期用，因为NODE_PATH已经被Node.js标记为废弃特性。

为什么会出现tsc能找到但ts-node不行的情况？ #

tsc是TypeScript的编译器，它会全局读取tsconfig.json的所有配置来解析模块路径。而ts-node在运行时，默认情况下可能只是编译单个入口文件，没有全局应用路径规则；再加上OCLIF的加载逻辑涉及动态require，这就导致ts-node的路径解析失效，只能退回到Node.js原生的模块查找规则——自然找不到my-module这种自定义绝对路径模块。

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