如何移除自研TS库引入路径中的dist，实现直接按包名导入？

问题原因 #

• 最常见的原因是发布的npm包未包含dist目录：如果你没有在package.json的files字段中明确声明要包含dist目录，且.gitignore/.npmignore中配置了忽略dist目录，npm发版时会自动剔除dist文件夹，导致main字段指定的dist/index.js路径不存在，无法直接从包根路径导入。
• 第二个原因是package.json入口配置不全：你当前只配置了CommonJS规范的main入口，没有适配ES模块导入、TypeScript类型识别的相关字段，现代打包工具和高版本Node.js无法正确识别默认入口。
• 第三个可能的原因是TypeScript编译后的目录结构不符合预期：你当前tsconfig使用的是rootDirs配置（适用于多源码目录场景），单源码目录场景下可能导致编译后的index.js没有直接生成在dist根目录下，入口文件路径不匹配。

解决步骤 #

步骤1：调整tsconfig配置（可选，若编译产物路径正确可跳过） #

将tsconfig.json中的rootDirs替换为rootDir，指定单一源码根目录，确保编译后的目录结构和预期一致：

{
  "compilerOptions": {
    // 其他配置保留
    "rootDir": "lib",
    // 删掉原有的rootDirs配置
  }
}

执行npm run build后确认dist目录下存在index.js和index.d.ts两个文件。

步骤2：完善package.json配置 #

新增/修改package.json中的以下字段：

{
  // 原有配置保留
  "main": "dist/index.js",
  "module": "dist/index.js",
  "types": "dist/index.d.ts",
  "exports": {
    ".": {
      "import": "./dist/index.js",
      "require": "./dist/index.js",
      "types": "./dist/index.d.ts"
    }
  },
  "files": ["dist"]
}

各字段作用说明：

• module：供webpack、vite等支持ES模块的打包工具识别的入口，优先级高于main字段
• types：TypeScript识别的类型声明文件入口，解决导入时类型缺失的问题
• exports：高版本Node.js和现代打包工具优先读取的入口配置，明确限制包的可访问路径
• files：明确指定npm发版时需要包含的文件/目录，优先级高于忽略规则，避免dist被误删

步骤3：验证效果 #

修改完成后重新构建，重新发布npm包（或本地使用npm link做软连接测试），即可直接通过import hello from '@org/library'导入。

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