在 package.json 中配置条件导出字段,需要在 exports 对象下定义一个键名为 ./* 的路径映射。该映射的值是一个包含 import、require 和 default 等条件的对象,通过指定不同环境下的文件路径来实现按需加载。

如何为特定模块设置多环境导出?
针对单个文件或目录的导出,可以在 exports 中使用通配符或具体路径作为键,并为其分配一个包含多个环境条件的对象。例如,可以为 ./index.js 同时提供 ESM 和 CommonJS 两种入口,确保在不同构建工具或运行环境中都能正确解析。

{
"name": "my-package",
"version": "1.0.0",
"type": "module",
"exports": {
".": {
"import": "./dist/index.mjs",
"require": "./dist/index.cjs"
},
"./utils": {
"import": "./src/utils.mjs",
"default": "./src/utils.js"
}
}
}
上述配置中,当使用 import 语句引入时,会优先匹配 import 条件指向的 .mjs 文件;若使用 require 或旧版打包工具,则回退到 require 条件指向的 .cjs 文件。对于 ./utils,如果没有匹配的 import 或 require,则会使用 default 作为兜底策略。
如何处理子路径的动态导入?
如果需要支持包内所有子文件的动态导入,可以使用通配符 .* 来捕获任意后缀。这种配置方式允许外部代码通过 import('./my-package/some-file') 的方式访问内部资源,而无需在 exports 中逐一列出每个文件。

{
"name": "my-package",
"version": "1.0.0",
"exports": {
".": "./src/index.js",
"./components/*": {
"import": "./dist/components/*.mjs",
"require": "./dist/components/*.cjs",
"default": "./src/components/*.js"
}
}
}
在此配置下,./components/* 会匹配所有以 ./components/ 开头的子路径。开发者可以导入 ./components/Button,系统会根据当前环境自动选择对应的 .mjs、.cjs 或 .js 文件。这种模式极大地简化了大型库的子模块管理,避免了手动维护冗长的导出列表。
当所有条件都不匹配时默认返回什么?
如果在 exports 配置中未显式声明 default 条件,且当前环境无法匹配任何已定义的条件(如 import 或 require),Node.js 和现代浏览器将抛出 ERR_PACKAGE_PATH_NOT_EXPORTED 错误。这意味着该路径被视为私有或未公开,外部无法访问。因此,为了保证兼容性,通常建议在关键路径中保留 default 作为最后的手段,或者明确只支持特定环境而不提供兜底。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南











