TS monorepo中模块入口高于package.json时无法定位模块问题

是的，Node.js 模块解析机制（TypeScript 依赖这套机制）明确禁止模块的main字段使用向上遍历的路径（即../开头的路径），这是模块解析的安全规范限制。

原因详解 #

你的@thess/hello包通过符号链接指向了libs/hello目录，Node.js 会将libs/hello认定为这个包的根目录。当你把main设为../../dist/libs/hello/index.js时，相当于要求模块解析器跳出当前包的根目录去加载外部文件——这种跨包边界的路径会被解析器直接拒绝，哪怕文件实际存在也无法被识别。

可行解决方案 #

方案1：用 TypeScript 路径映射统一管理模块解析

在根目录创建全局tsconfig.json，通过paths配置直接将@thess/*映射到根dist目录的构建产物：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@thess/*": ["dist/libs/*"]
    },
    "declaration": true
  },
  "include": ["apps/**/*", "libs/**/*"],
  "references": [{"path": "./apps/web"}, {"path": "./libs/hello"}]
}

然后让每个子项目的tsconfig.json继承根配置：

// libs/hello/tsconfig.json
{
  "extends": "../../tsconfig.json",
  "compilerOptions": {
    "outDir": "../../dist/libs/hello"
  }
}

同时修改libs/hello/package.json的字段：

{
  "main": "index.js",
  "types": "index.d.ts",
  "scripts": {
    "build": "tsc"
  }
}

这样 TypeScript 会直接从根dist/libs/hello解析模块，绕过符号链接的路径限制。

方案2：调整构建产物的同步逻辑

保持库的outDir为./dist（即libs/hello/dist），然后添加根目录脚本，在构建完成后将libs/hello/dist同步到根dist/libs/hello：

// package.json 根目录
{
  "scripts": {
    "build:libs": "pnpm --filter @thess/hello build && cp -r libs/hello/dist dist/libs/hello"
  }
}

这种方式保持main字段为dist/index.js（符合模块解析规范），同时实现了产物统一输出到根dist的需求。

总结 #

核心限制来自 Node.js 模块解析的安全规则：包的main字段必须指向包根目录内部的路径，不能通过../跳出当前包边界。通过 TypeScript 路径映射或构建后同步的方式，既能满足产物统一输出的需求，又能符合模块解析规范。

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