TypeScript无法导入含初始化值的依赖？nx monorepo+ts-node问题

问题场景 #

在NX monorepo环境中使用ts-node运行TypeScript代码时，出现枚举导入后使用异常：

• 共享文件B.ts导出枚举：

  export enum Test {
    A,
    B,
  }
  

• A.ts版本1（无法运行）：直接在对象字面量中引用枚举成员

  import { Test } from "@platform/ts-shared";
  const testObject = {
      type: Test.A
  }
  

• A.ts版本2（可正常运行）：使用类型断言声明对象类型

  import { Test } from "@platform/ts-shared";
  const testObject = {} as Test
  

版本1报错，且其他非接口/类的对象初始化也存在类似问题，仅类型断言方式可用。

核心原因 #

1. ts-node模块解析不匹配NX配置：ts-node未正确读取NX monorepo的路径别名与编译配置，导致仅识别枚举的类型信息，无法加载其运行时对象。版本2的类型断言属于编译时操作，无需访问枚举运行时值，因此不受影响。
2. TypeScript枚举编译选项缺失：未启用preserveConstEnums等关键选项，导致枚举仅被编译为类型，未生成运行时可访问的枚举对象。
3. NX缓存或构建不完整：共享包@platform/ts-shared未正确构建，缓存残留导致枚举运行时代码未被加载。

解决方案 #

1. 指定ts-node使用NX的tsconfig配置 #

运行ts-node时明确指定项目的tsconfig文件（优先根目录的tsconfig.base.json或对应包的tsconfig.json）：

ts-node --project ./tsconfig.base.json ./src/A.ts

或在package.json的scripts中配置：

"scripts": {
  "run:A": "ts-node --project ./tsconfig.base.json ./src/A.ts"
}

2. 检查并修正TypeScript编译选项 #

在tsconfig文件中确保以下配置：

{
  "compilerOptions": {
    "preserveConstEnums": true, // 保留枚举的运行时对象
    "isolatedModules": false, // 避免隔离模块模式影响枚举导出
    "module": "CommonJS" // 匹配ts-node默认的模块系统
  }
}

3. 重建共享包并清理NX缓存 #

执行以下命令确保共享包构建完整并清理缓存：

nx build ts-shared
nx reset

4. 验证路径别名配置正确性 #

检查tsconfig.base.json中的paths配置，确保@platform/ts-shared指向正确的文件路径：

{
  "compilerOptions": {
    "paths": {
      "@platform/ts-shared": ["packages/ts-shared/src/index.ts"]
    }
  }
}

5. 临时替代方案（不推荐长期使用） #

若上述方案暂未生效，可直接使用枚举的数值/字符串值替代：

const testObject = {
    type: 0 // Test.A对应的默认数值为0
}

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