Lerna@3.16+TypeScript+VSCode中如何排除特定自动导入路径？

我之前也处理过类似的Lerna + TypeScript多包项目的自动导入路径问题，咱们一步步来调整配置，搞定这个麻烦：

1. 先把每个子包的package.json配置做对 #

这是让编辑器和TypeScript识别正确导入路径的基础，每个子包（format、helper）的package.json必须明确声明包名和入口信息：

• 把name字段设置为@org-name/format和@org-name/helper
• 配置main、module、types字段指向编译后的文件，比如helper包的配置：

{
  "name": "@org-name/helper",
  "main": "dist/index.js",
  "module": "dist/index.esm.js",
  "types": "dist/index.d.ts",
  // 其他字段（比如scripts、dependencies）保持不变
}

这样TypeScript会默认优先用包名来解析依赖，而不是直接定位到源码目录。

2. 配置根目录tsconfig的路径映射 #

在根目录的tsconfig.lib.json里添加paths配置，明确告诉TypeScript@org-name/*对应的子包源码位置，引导自动导入工具生成正确路径：

{
  "compilerOptions": {
    "baseUrl": ".",
    "paths": {
      "@org-name/*": ["packages/*/src"]
    },
    // 其他编译选项（比如target、module等）保持原有配置
  },
  "include": ["packages/*/src"]
}

这个映射会让TypeScript把@org-name/helper关联到packages/helper/src，既保证类型解析正常，又能让自动导入优先生成包名路径，而非packages/helper这类相对路径。

3. 调整编辑器的自动导入偏好（以VS Code为例） #

如果用的是VS Code，你可以调整设置强制自动导入优先用包名：
打开设置（快捷键Ctrl+,），搜索typescript.preferences.importModuleSpecifier，将其设置为"non-relative"。这个选项会让编辑器优先使用非相对路径（也就是包名）来导入项目内的子包，避免生成指向packages目录的路径。

4. 重新链接Lerna包并排除冗余路径 #

• 运行lerna bootstrap重新建立子包之间的软链接，确保Lerna正确处理了包依赖关系
• 如果还是出现packages/helper/dist这类路径，在根tsconfig的exclude字段里添加packages/*/dist，让TypeScript忽略编译后的目录：

{
  "compilerOptions": { /* ... */ },
  "exclude": ["node_modules", "packages/*/dist"]
}

按照这些步骤配置后，自动导入应该只会生成@org-name/helper这样的正确路径，同时完全不影响现有导入功能——TypeScript会通过路径映射和package.json配置正常解析所有依赖。

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