如何让Node.js子路径导入在编译后的声明文件中生效

1. 修正package.json中的子路径类型映射 #

当前你的package.json的imports字段仅配置了JS文件路径，未为类型文件提供映射，导致TS无法解析声明文件里的#utils。需修改imports，为子路径同时指定类型和JS入口：

{
  "name": "module-a",
  "packageManager": "yarn@3.6.1",
  "exports": {
    ".": {
      "types": "./build/index.d.ts", // 修正：与实际生成的声明文件路径保持一致
      "default": "./build/index.mjs"
    }
  },
  "private": true,
  "devDependencies": {
    "typescript": "^5.1.6"
  },
  "scripts": {
    "build": "rm -rf build && tsc"
  },
  "imports": {
    "#utils": {
      "types": "./build/utils/index.d.ts",
      "default": "./build/utils/index.mjs"
    }
  }
}

注意：原exports中的types路径为./build/index.d.mts，但实际生成的声明文件是index.d.ts，必须修改为一致路径，否则其他项目导入时会找不到类型入口。

2. 确认TS编译配置正确性 #

你的tsconfig.json已设置moduleResolution: "Node16"，该配置符合要求——Node16解析模式会读取package.json的imports和exports字段。无需额外修改，只需确保include和outDir配置正确，保证所有源码都能编译到build目录。

3. 解决跨项目子路径冲突问题 #

父项目存在同名子路径#utils时出现解析错误，核心原因是module-a的类型映射配置缺失，导致TS向上遍历到父项目的package.json查找映射。完成步骤1的配置后，TS会优先使用module-a自身package.json的imports配置，不会再错误解析父项目的子路径。

验证步骤 #

1. 重新执行yarn build编译module-a
2. 在module-a内部，VSCode应能正确解析声明文件里的#utils
3. 将module-a作为依赖引入其他项目，TS会读取module-a的package.json配置，正确解析#utils类型，不再与父项目子路径混淆

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