Parcel+TypeScript Monorepo本地依赖导入报错：Cannot resolve dependency

我之前也碰到过一模一样的情况——VS Code能正常跳转提示，但Parcel构建就报错，核心原因是Parcel 默认不遵循 TypeScript 的 paths 配置规则：编辑器是靠tsconfig来做路径识别和跳转的，但Parcel有自己独立的模块解析逻辑，所以才会出现这种“编辑器正常，构建失败”的矛盾情况。下面是具体的解决步骤：

1. 给每个子包配置正确的package.json #

首先得确保每个子包的package.json都设置了关键字段，让Parcel能识别包名对应的入口：

• 比如在packages/f-app-hub/package.json中：

{
  "name": "f-app-hub", // 必须和你导入时用的包名完全一致
  "source": "index.tsx", // Parcel推荐用source指定入口，也可以用main字段
  "private": true // 标记为私有包，避免意外发布到npm
}

其他子包（f-app-core、f-app-notes）也照此配置，name字段要和你跨包导入时的包名一一对应。

2. 修正tsconfig的paths配置 #

你当前的paths用了~/*的模糊匹配，但Parcel的路径解析插件需要更明确的包名映射。结合你设置的baseUrl: "packages"，调整paths为：

{
  "compilerOptions": {
    "jsx": "react",
    "esModuleInterop": true,
    "baseUrl": "packages",
    "rootDir": ".",
    "paths": {
      "f-app-core": ["f-app-core/index.tsx"],
      "f-app-hub": ["f-app-hub/index.tsx"],
      "f-app-notes": ["f-app-notes/index.tsx"]
    }
  },
  "include": ["packages/**/*"]
}

这样TypeScript和后续的Parcel插件都能清晰识别包名对应的文件路径。

3. 给Parcel添加tsconfig路径解析支持 #

Parcel本身不处理tsconfig的paths，需要安装专门的解析器插件来打通这个环节：

npm install parcel-resolver-tsconfig-paths --save-dev

然后在项目根目录创建.parcelrc文件，把这个插件加入Parcel的解析器链：

{
  "extends": "@parcel/config-default",
  "resolvers": ["parcel-resolver-tsconfig-paths", "..."]
}

这里的"..."是保留Parcel默认的解析器，绝对不能去掉，否则会丢失其他默认的模块解析能力。

4. 验证构建效果 #

现在重新运行Parcel的构建命令（比如parcel build packages/f-app/index.tsx），应该就能正常解析import Hub from 'f-app-hub'这种包名导入方式了。

额外注意点 #

• 确保所有子包都在packages目录下，和baseUrl的配置完全对应；
• 如果你用的是Parcel 2.x版本，上面的插件和配置都是完全兼容的；
• 每个子包的入口文件路径要和paths里的映射完全一致，避免出现文件找不到的情况。

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