自定义NPM库多入口场景下VSCode自动导入功能失效求助

针对你遇到的手动导入正常，但VSCode无法自动提示导入的问题，核心原因是TypeScript未正确索引到包中子路径的类型定义，导致编辑器无法识别可用的导出成员。可通过以下步骤修复：

1. 补充typesVersions配置 #

在NPM库的package.json中添加typesVersions字段，明确映射每个子路径的类型文件位置，让TypeScript能正确解析各子路径的类型：

"files": [
  "dist/**/*"
],
"exports": {
  "./common": {
    "import": "./dist/common/index.esm.js",
    "require": "./dist/common/index.js",
    "types": "./dist/types/common/index.d.ts"
  },
  "./server": {
    "import": "./dist/server/index.esm.js",
    "require": "./dist/server/index.js",
    "types": "./dist/types/server/index.d.ts"
  },
  "./client": {
    "import": "./dist/client/index.esm.js",
    "require": "./dist/client/index.js",
    "types": "./dist/types/client/index.d.ts"
  }
},
"typesVersions": {
  "*": {
    "common": ["./dist/types/common/index.d.ts"],
    "server": ["./dist/types/server/index.d.ts"],
    "client": ["./dist/types/client/index.d.ts"]
  }
}

2. 确保类型文件正确导出成员 #

检查每个子路径的index.d.ts文件，确保需要自动导入的类型（比如myType）是顶级导出，示例：

// dist/types/server/index.d.ts
export { myType } from './my-type';
// 或直接定义并导出
export type myType = { /* 类型定义内容 */ };

3. 验证项目的TypeScript配置 #

在使用该库的项目中，确保tsconfig.json的moduleResolution设置为node16或nodenext，这是正确解析exports字段的必要条件：

{
  "compilerOptions": {
    "moduleResolution": "node16",
    // 其他配置项...
  }
}

4. 重新发布并更新依赖 #

修改完成后重新打包发布你的NPM库，在使用项目中更新依赖包，重启VSCode后，自动导入提示即可正常工作。

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