Yarn Workspace下TypeScript包路径简化：优化导入层级

关于typesVersions是否推荐 #

在Node 18+搭配TypeScript 4.7+的环境下，typesVersions并非必须，也谈不上"不推荐"——它更多是为了兼容**旧版TypeScript（<4.7）**或使用node模块解析模式的场景。如果你的项目只需要支持现代环境，完全可以不用typesVersions。

仅用exports实现简化导入的方案 #

可以做到，只需调整utils包的配置和消费端的TS解析模式，无需维护根index.ts或typesVersions，具体步骤如下：

1. 优化utils包的TS编译配置 #

修改shared/utils/tsconfig.json，添加rootDir字段，确保编译后的文件直接输出到dist根目录（避免生成dist/src这种多余层级）：

{
  "compilerOptions": {
    "target": "es6",
    "moduleResolution": "node16", // 改为node16/nodenext，和消费端保持一致
    "esModuleInterop": true,
    "isolatedModules": true,
    "incremental": true,
    "skipLibCheck": true,
    "allowJs": true,
    "resolveJsonModule": true,
    "composite": true,
    "declaration": true,
    "declarationMap": true,
    "sourceMap": true,
    "outDir": "dist",
    "baseUrl": "src",
    "rootDir": "src" // 新增：指定源码根目录，编译后移除src层级
  },
  "include": ["src"],
  "exclude": ["node_modules"]
}

2. 配置utils包的package.json的exports字段 #

在shared/utils/package.json中，通过exports同时映射JS文件和类型文件（TypeScript 4.7+会读取types条件）：

"exports": {
  "./*": {
    "types": "./dist/*.d.ts",
    "import": "./dist/*.js",
    "require": "./dist/*.js"
  }
}

这样当你导入@acme/utils/logger时，Node会自动解析到dist/logger.js，TypeScript会解析到dist/logger.d.ts。

3. 调整消费端的TS解析模式 #

在next/tsconfig.json和nest/tsconfig.json中，将moduleResolution设置为node16或nodenext（必须和utils包的配置一致，否则TS无法识别exports中的类型映射）：

{
  "compilerOptions": {
    "moduleResolution": "node16",
    // 其他原有配置...
  }
}

验证 #

重新编译utils包后，在Next.js或Nest应用中直接使用：

import logger from "@acme/utils/logger";

即可正常导入，无需拼接dist/src路径。

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