基于npm workspaces搭建TypeScript Monorepo库的导入问题排查

针对用npm workspaces搭建Monorepo时出现的「Cannot find module '@opoint/storedsearch'」错误，以下是修复PR中的核心改动：

1. 补全子模块package.json的多环境入口配置 #

之前子模块的package.json可能只配置了main字段，没法同时适配CommonJS、ES模块和TypeScript的解析需求。修复时给每个子模块（比如@opoint/storedsearch）补充了完整的入口字段：

{
  "main": "./dist/index.js",
  "types": "./dist/index.d.ts",
  "module": "./dist/index.esm.js",
  "exports": {
    ".": {
      "require": "./dist/index.js",
      "import": "./dist/index.esm.js",
      "types": "./dist/index.d.ts"
    }
  }
}

这一步让Node.js、ES模块运行时和TS编译器都能精准找到对应的入口文件，npm workspaces会基于这些字段正确映射子模块的路径。

2. 修正根目录tsconfig.json的路径映射 #

之前根tsconfig可能没开启baseUrl或者paths配置不全，导致TS开发阶段无法识别@opoint/xxx的路径。修复时在根tsconfig.json中添加：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@opoint/*": ["packages/*/src"]
    }
  },
  "include": ["packages/**/*"]
}

这配置让TS编译器在开发时能直接解析子模块的源码路径，同时保证构建后npm workspaces能关联到编译后的产物路径。

3. 统一子模块的构建产物输出路径 #

之前不同子模块的构建输出路径可能混乱，导致npm workspaces无法正确关联产物。修复时统一每个子模块的build脚本，将产物输出到固定的dist目录，且保证编译后的文件结构和源码目录对应：

{
  "scripts": {
    "build": "tsc --project tsconfig.build.json"
  }
}

固定的产物位置让npm workspaces在link子模块时能精准找到入口文件，避免路径错乱。

4. 精确配置根package.json的workspaces字段 #

之前workspaces配置可能过于宽泛，甚至把测试、示例目录也纳入识别范围，引发解析冲突。修复时明确指定只识别packages目录下的子模块：

{
  "workspaces": [
    "packages/*"
  ]
}

这一步让npm workspaces聚焦于真正的子模块，减少无关目录带来的解析干扰。

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