配置 package.json 的 exports 字段需要采用条件导出语法,以同时支持 node.js、现代浏览器和旧版打包工具。具体做法是定义一个根路径映射,并在其中分别指定 import(esm)、require(cjs)和 default(回退)对应的文件路径,这样不同环境的加载器就能自动匹配正确的模块格式。

如何为单入口包配置多环境导出
对于大多数库,只需在 exports 中为根路径 . 设置条件对象即可。Node.js 会优先检查 import 或 require 键,而 Webpack 等构建工具通常依赖 default 或 browser 键。这种配置确保了无论调用方使用哪种机制,都能获得兼容的代码。

{
"name": "my-lib",
"version": "1.0.0",
"main": "./dist/cjs/index.js",
"module": "./dist/esm/index.js",
"exports": {
".": {
"import": "./dist/esm/index.js",
"require": "./dist/cjs/index.js",
"default": "./dist/cjs/index.js"
}
}
}上述配置中,import 指向 ESM 文件,require 指向 CJS 文件。当使用 import 'my-lib' 时,Node.js 和浏览器会加载 ESM 版本;当使用 require('my-lib') 时,会加载 CJS 版本。default 作为兜底,确保在不明确指定条件的情况下也能正常工作。
立即学习“Java免费学习笔记(深入)”;
exa-js 是 Exa 官方 JavaScript 软件开发工具包,Exa 是一个为 AI 工作流构建的网络搜索 API。它为代理提供了一种具体的方式来搜索网络、检索页面内容,并从代码中生成有来源的答案,而不是手动拼接原始 HTTP 调用。
如何为多入口包配置子路径导出
如果包包含多个入口点,如 utils 和 core,需要在 exports 中使用通配符或显式路径来定义每个子模块。这允许消费者按需导入特定功能,而不必加载整个包。每个子路径都必须独立配置其导出条件,以确保在不同环境中正确解析。

{
"name": "my-lib",
"version": "1.0.0",
"exports": {
".": {
"import": "./dist/esm/index.js",
"require": "./dist/cjs/index.js"
},
"./utils": {
"import": "./dist/esm/utils.js",
"require": "./dist/cjs/utils.js"
},
"./core": {
"import": "./dist/esm/core.js",
"require": "./dist/cjs/core.js"
}
}
}在此配置中,"." 对应主入口,"./utils" 和 "./core" 对应子模块。消费者可以使用 import utils from 'my-lib/utils' 或 const core = require('my-lib/core') 来导入特定部分。这种细粒度的控制有助于减小打包体积并提高加载效率。
基于 exports 字段的解析优先级问题
当 exports 字段存在时,Node.js 会完全忽略 main 字段,转而根据导入路径和条件对象进行解析。这意味着如果只配置了 exports 而未提供 main,旧版工具可能无法正确找到入口文件。此外,条件匹配的优先级是固定的:import > require > default,且必须确保所有条件都指向有效的文件路径,否则会导致解析失败。

















