大型开源库ESModule导出应默认导出主入口、命名导出细粒度功能，按功能拆分子模块支持路径导入，导出值需冻结保障不可变性，并提供语义清晰的树摇友好命名导出。
大型开源库设计 ESModule 导出接口，核心目标是兼顾“轻量”（按需加载、无冗余）和“友好”（易记、易用、不易出错）。这不单是语法问题，更是 API 设计与模块组织策略的结合。
默认导出 + 命名导出分层暴露
主入口推荐单一默认导出（如主类或工厂函数），同时提供细粒度命名导出供高级用户按需引入。
- 默认导出代表库的“最常用姿势”，名称简洁统一（如 import Vue from 'vue' 或 import L from 'leaflet'）
- 命名导出保留内部能力，比如 import { debounce, throttle } from 'lodash-es'，避免引入整包
- 不混用默认+命名导出在同一个文件里暴露多个顶层逻辑，容易让使用者困惑“该用哪个”
按功能拆分子模块，支持路径级导入
允许用户直接导入子模块，跳过主入口，实现真正轻量：
deep-java-review
下载
Java项目代码review工具。分析Git变更+完整调用链路上下文，推断业务需求，进行多维度评分和分类汇总，生成完整PRD文档。包含细粒度Java代码审查清单（Null安全、异常处理、Streams、并发、equals/hashCode、资源管理、API设计、性能、MyBatis/ORM、事务边界、SQL/DD...
- 导出结构示例：lib/index.js（默认导出主对象）、lib/utils.js（命名导出工具函数）、lib/types.js（类型定义）
- 用户可写 import { formatDate } from 'mylib/utils'，构建工具能精准打包该模块及其依赖
- 配合 package.json 的 "exports" 字段，可精确控制哪些路径对外可见、哪些仅限内部使用
导出值而非变量引用，保障不可变性
避免导出 let/const 声明后被外部意外修改，影响库状态一致性：
立即学习“Java免费学习笔记（深入）”；
- ✅ 推荐：export default Object.freeze({ version: '2.0', name: 'core' })
- ✅ 推荐：export const DEFAULT_OPTIONS = Object.freeze({ timeout: 5000 })
- ❌ 避免：let config = {}; export { config }（外部可改 config.timeout）
提供树摇友好的命名导出结构
命名导出天然支持静态分析，但需注意组织方式：
- 每个功能单独导出，不打包进一个大对象再解构（如避免 export const utils = { a(), b(), c() }）
- 保持导出名语义清晰、无缩写（export function parseJson() 比 export function pJ() 更友好）
- 对高频使用项提供默认导出别名，例如：export { parseJson as default }，方便习惯默认导入的用户
