VSCode+Turborepo本地包自动导入未识别主入口问题

问题背景 #

我们近期用Turborepo将多个仓库合并为单一Monorepo，目的是通过本地包提升代码复用性。项目结构如下：

/apps
| /app1
| /app2
/packages
| /package1
| | /some-folder
| | | someHelper.js
| | index.js // 主入口，导出所有内容

package1的package.json配置：

{
  "name": "package1",
  "main": "index.js",
  // 省略无关属性
}

应用（以app1为例）的package.json配置：

{
  "name": "app1",
  "dependencies": {
    "package1": "*"
  }
  // 省略无关属性
}

在app1中引用someHelper时，VSCode智能提示生成的导入语句为：

import someHelper from "<rootDir>/packages/package1/some-folder/someHelper";

我们期望的简洁导入方式为：

import { someHelper } from "package1";

两种导入方式均能正常运行，但后者更符合Monorepo的使用习惯。我们尝试在应用、包及根目录配置不同的jsconfig.json路径别名组合，均未达到预期效果，请问遗漏了哪些配置？

解决方案 #

1. 确认package1入口文件的导出逻辑 #

首先要确保packages/package1/index.js已正确导出目标模块：

// packages/package1/index.js
export { someHelper } from './some-folder/someHelper';

2. 配置根目录的jsconfig.json（或tsconfig.json） #

在Monorepo根目录创建jsconfig.json，通过compilerOptions.paths映射本地包路径，让VSCode能识别包名导入：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "package1": ["packages/package1/index.js"],
      "package1/*": ["packages/package1/*"]
    }
  },
  "include": ["apps/**/*", "packages/**/*"]
}

如果项目使用TypeScript，将jsconfig.json替换为tsconfig.json，配置逻辑一致，同时建议子包/应用的tsconfig.json通过extends字段继承根配置。

3. 重启VSCode语言服务 #

按Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（Mac），输入Reload Window重启编辑器，让新配置生效。

4. 确认依赖安装状态 #

在根目录执行npm install或pnpm install，确保包管理器正确关联本地包，让VSCode能识别package1作为依赖包的身份。

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