Turborepo创建的仅发包Monorepo发布到NPM后，根模块导入失败的配置问题咨询

兄弟，你踩的这个坑我之前帮好几个开发者排查过，核心问题确实出在根package.json的配置缺失和发布逻辑的小细节上，咱们一步步理清楚：

1. 根目录必须配置入口文件与对应package.json字段 #

你现在的问题本质是：当别人执行import { useHook } from 'appname'时，Node.js/TypeScript根本不知道该从哪个文件加载内容——因为你的根package.json既没设置main/module/types这类入口字段，也没有对应的入口文件。

解决步骤：

• 先在根目录创建一个入口文件，比如index.js（如果用TypeScript就建index.ts），把你想通过根模块暴露的子包内容导出，示例如下：

  // 根目录index.js
  // 直接导出所有子包的内容，方便用户一次性导入
  export * from './packages/react/dist';
  export * from './packages/utils/dist';
  
  // 或者按命名空间导出，让用户可以按需引用子模块
  // export { default as react } from './packages/react/dist';
  // export { default as utils } from './packages/utils/dist';
  

• 然后在根package.json里补充入口配置：

  {
    "name": "appname",
    "main": "./index.js", // CommonJS入口
    "module": "./index.js", // ES模块入口（如果你的包用ES模块）
    "types": "./index.d.ts" // TypeScript类型声明入口（TS项目必填）
  }
  

  如果你用TypeScript，记得把根index.ts编译成index.js，或者直接在配置里指向编译后的文件路径。

2. 一定要过滤发布文件，别把开发文件传到NPM #

你现在发布的包带着整个monorepo的开发文件（比如pnpm-workspace.yaml、turbo.json、未编译的源码），这不仅增大包体积，还可能导致导入逻辑混乱。

解决方法：在根package.json里添加files字段，明确指定要发布的文件：

{
  "files": [
    "packages/react/dist",
    "packages/utils/dist",
    "index.js",
    "index.d.ts" // 有类型声明的话加上
  ]
}

这样NPM只会把你指定的文件上传，避免冗余文件干扰。

3. 可选优化：支持子包直接导入（appname/react） #

如果想让用户既能通过appname导入所有内容，又能单独导入appname/react、appname/utils，可以用更现代的exports字段替代单一的main，在根package.json里配置：

{
  "exports": {
    ".": "./index.js", // 根模块入口
    "./react": "./packages/react/dist/index.js", // react子包入口
    "./utils": "./packages/utils/dist/index.js" // utils子包入口
  },
  // TypeScript用户还要补充typesVersions，确保类型能被正确识别
  "typesVersions": {
    "*": {
      "react": ["./packages/react/dist/index.d.ts"],
      "utils": ["./packages/utils/dist/index.d.ts"]
    }
  }
}

配置后用户两种导入方式都能正常工作，体验更友好。

4. 发布前本地验证，避免踩坑 #

发布前可以用npm pack命令生成一个本地的tar包，然后在测试项目里执行npm install ./path/to/your-appname.tgz，测试导入是否正常，没问题再正式发布到NPM。

内容来源于stack exchange