ERR_PACKAGE_PATH_NOT_EXPORTED 错误

云边有个小卖部

一、理解错误原因

二、具体解决步骤

1. 检查 package.json 中的 exports 字段

错误示例（可能导致报错）：

正确配置示例：

注意：

2. 检查 main/module/types 等入口字段

常见错误场景：

解决：

3. 检查项目文件结构与导出路径的匹配性

4. 临时移除 exports 字段（快速排查）

遇到 ERR_PACKAGE_PATH_NOT_EXPORTED 错误时，通常与包的 导出配置（package.json 中的 exports 字段） 或 文件路径映射 有关，并非 cnpm 仓库特有的问题（本质是包本身的结构/配置不符合 Node.js 模块导出规范）。以下是具体解决步骤：

一、理解错误原因

ERR_PACKAGE_PATH_NOT_EXPORTED 意为“包的导出路径未正确配置”，常见触发场景：

package.json 中配置了 exports 字段，但指定的路径不存在或格式错误；
入口文件（main/module 字段）指向的文件不存在；
导出路径与实际项目文件结构不匹配（如拼写错误、路径层级错误）；
使用了 Node.js 不支持的导出格式（如通配符滥用、子路径配置错误）。

二、具体解决步骤

1. 检查 package.json 中的 `exports` 字段

如果你的包配置了 exports（用于指定模块导出路径，常见于 ESM 包），需确保格式和路径完全正确。

错误示例（可能导致报错）：

{
  "exports": {
    ".": "./dist/index.js",  // 假设实际文件是 ./dist/main.js（路径错误）
    "./utils": "./src/utils" // 缺少文件后缀，或实际路径是 ./src/utils/index.js
  }
}

正确配置示例：

{
  "exports": {
    ".": "./dist/index.js",  // 确保路径指向实际存在的文件
    "./utils": "./src/utils/index.js"  // 完整路径（包括文件名和后缀）
  }
}

注意：

exports 中的路径必须是 相对路径（以 ./ 开头）；
路径需指向 具体文件（而非目录，除非目录下有 package.json 或 index.js）；
避免使用 Node.js 不支持的通配符（如 ./src/*，低版本 Node 不兼容）。

2. 检查 `main`/`module`/`types` 等入口字段

如果未配置 exports，则需确保 main（CommonJS 入口）、module（ESM 入口）等字段指向的文件存在。

常见错误场景：

配置了 main: "dist/index.js"，但忘记执行构建命令（如 npm run build），导致 dist 目录不存在；
路径拼写错误（如 dist/index.js 写成 dist/indexs.js）；
入口文件依赖的其他文件缺失（间接导致入口文件无法正常导出）。

解决：

执行构建命令（如 npm run build），确保 dist 等输出目录生成；
手动检查路径是否存在（如终端执行 ls dist/index.js 或 dir dist\index.js 验证）；
修正路径拼写错误（区分大小写，如 Dist 和 dist 在 Linux/macOS 上是不同的）。

3. 检查项目文件结构与导出路径的匹配性

确保导出配置的路径与实际文件结构完全一致。例如：

若项目结构为：

your-package/
├── dist/
│   └── index.js  # 构建后的入口文件
└── package.json

则 main 字段必须指向 ./dist/index.js（而非 ./src/index.js，除非未构建直接发布源码）。

4. 临时移除 `exports` 字段（快速排查）

如果不确定 exports 配置是否正确，可临时删除 exports 字段，仅保留 main 字段，测试是否还会报错：

{
  "main": "./dist/index.js",  // 仅保留入口配置
  // 暂时删除 "exports" 字段
}

若删除后发布成功，说明问题出在 exports 的配置上，需重新调整其格式和路径。

5. 测试本地导入是否正常

发布前先在本地验证包是否能正常导入，避免仓库发布时才发现问题：

在包的根目录执行 npm link（将包链接到全局）；
创建一个测试项目，执行 npm link your-package-name（关联本地包）；

在测试项目中尝试导入：

// 测试 CommonJS 导入
const myPackage = require('your-package-name');

// 测试 ESM 导入（若支持）
import myPackage from 'your-package-name';

若本地导入报错，说明包的导出配置确实有问题，需先修复再发布。

6. 检查 Node.js 版本兼容性

低版本 Node.js（如 v12 及以下）对 exports 字段的支持不完善，可能导致解析错误。建议：

确保本地开发环境使用 Node.js v14+（对 ESM 和 exports 支持更稳定）；
在 package.json 中添加 engines 字段声明支持的 Node 版本，避免用户使用低版本：
```
{
  "engines": {
    "node": ">=14.0.0"
  }
}
```

三、重新发布到 cnpm

修复配置后，按以下步骤重新发布：

确保已切换到 cnpm 镜像：

npm config set registry https://registry.npm.taobao.org

升级版本号（同一版本号不能重复发布）：

npm version patch  # 修订号+1（如 1.0.0 → 1.0.1）

重新发布：
```
npm publish
```

总结

ERR_PACKAGE_PATH_NOT_EXPORTED 本质是包的 导出配置与实际文件结构不匹配，核心解决思路是：

检查 exports、main 等字段的路径是否正确；
确保入口文件及依赖文件存在（执行构建命令）；
本地测试导入是否正常，再重新发布。