模块导出臃肿需按能力域切分、场景隔离、稳定性分层；收敛配置为命名空间对象；封装高频组合为意图型函数；用类型守门与默认导出统一入口。
模块导出臃肿，本质是职责混杂和边界模糊。解决关键不在“删什么”，而在“怎么分”——按能力域切分、按使用场景隔离、按稳定性分层。
按能力域拆分：一个模块只暴露一类行为
比如一个 userUtils.js 原本导出 12 个函数：验证、格式化、权限判断、头像生成、埋点上报……这已不是工具模块，而是拼盘。应拆为：
-
userValidation.js：仅含isValidEmail、isStrongPassword等校验函数 -
userFormat.js：只处理姓名截断、手机号掩码、时间相对化等格式逻辑 -
userPermission.js：专注角色检查、权限码解析、访问控制辅助
每个模块导出不超过 4–5 个高内聚函数，命名直指用途（如 formatPhoneMask 而非 format），使用者一眼可知“这里只做格式，不碰权限”。
用命名空间对象收敛低频/配置类导出
避免零散导出一堆常量或默认配置，把它们收进一个语义明确的对象中：
立即学习“Java免费学习笔记（深入）”；
- ❌ 不推荐：
export const DEFAULT_PAGE_SIZE = 10;、export const STATUS_ACTIVE = 'active';、export const API_TIMEOUT = 8000; - ✅ 推荐：
export const userConfig = { pageSize: 10, status: { active: 'active', inactive: 'inactive' }, timeout: 8000 };
这样既减少命名污染，又提升可读性——调用时写 userConfig.status.active 比裸名 STATUS_ACTIVE 更易追溯来源，也方便后续扩展（如加 userConfig.apiBase）。
对高频组合操作封装“意图型”函数
当多个导出函数总被一起调用（如每次都要先 validate 再 format 再 save），说明缺少更高阶的抽象。与其让用户手动编排，不如提供表达业务意图的封装：
- 原有导出：
validateUser、normalizeUserData、persistUser - 新增导出：
registerUser（内部顺序调用前三者，统一错误处理与事务逻辑） - 保留原始函数供特殊场景复用，但主流程推荐使用
registerUser
这类函数不增加模块体积，反而降低使用复杂度，且天然形成稳定接口边界——只要 registerUser 行为不变，内部实现可随时重构。
用类型守门 + 默认导出控制入口粒度
在模块顶层用 TypeScript 类型或 JSDoc 明确导出契约，并优先采用默认导出对象统一出口：
/** @type {{ validate: typeof validateUser; format: typeof formatUser; register: typeof registerUser }} */
const UserAPI = {
validate: validateUser,
format: formatUser,
register: registerUser
};
<p>export default UserAPI;
// 不再单独 export validateUser / formatUser（除非必要）
这样使用者只需导入一次：import UserAPI from './userAPI.js'，IDE 自动提示可用方法，避免从同一模块反复解构不同函数造成认知负担。真正需要细粒度导入的场景（如 Tree-shaking），再通过具名导出配合构建工具处理。
