JavaScript模块化通过顶层作用域天然实现私有变量封装，未export的变量、函数仅在模块内可见；支持命名导出（多个功能）和默认导出（主入口），可重命名、聚合或转发导出；需避免直接暴露私有数据，推荐函数封装或Object.freeze()确保安全性。
JavaScript 模块化天然支持私有变量管理——模块顶层作用域内的变量、函数默认不对外暴露，只有显式用 export 标记的才可被外部导入。这不是靠技巧模拟，而是语言级封装机制。
私有变量自动隔离
在模块文件（如 utils.js）中直接声明的变量、函数、类，只要不加 export，就只在该模块内部可见：
-
const internalCache = new Map();—— 外部无法访问，也不会污染全局 -
function validateEmail(email) { /* 内部校验逻辑 */ }—— 只供本模块内其他导出函数调用 - 即使导出函数内部调用了这些私有项，外部仍无法直接获取或修改它们
导出函数的两种主流方式
根据使用场景选择命名导出或默认导出，二者互不冲突，但语义不同：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
-
命名导出：适合导出多个相关功能，导入时需按名解构
export function formatPrice(amount) { ... }export function formatDate(date) { ... }
导入：import { formatPrice, formatDate } from './utils.js' -
默认导出：适合导出模块主入口（如一个类、工厂函数或核心工具）
export default class ApiClient { ... }
导入：import ApiClient from './api.js'（无需花括号，名称可自定义）
导出时重命名与聚合
当需要统一接口或避免命名冲突，可在导出环节调整：
立即学习“Java免费学习笔记（深入）”；
- 重命名导出：
export { internalHelper as processItem } - 聚合导出（含重命名）：
export { formatPrice as price, formatDate as date } from './formatters.js' - 甚至转发导出：
export * from './math.js'（导出所有命名项），或export { add as sum } from './math.js'
避免意外暴露的常见陷阱
看似安全的操作可能打破封装：
- 不要在导出对象中直接引用私有变量（除非你明确希望它被外部修改）：
❌export const config = { cache: internalCache };→ 外部可改config.cache.clear()
✅ 改用函数封装：export function getCacheSize() { return internalCache.size; } - 默认导出如果是对象字面量，其属性仍是可变的；若需真正不可变，用
Object.freeze()或只导出 getter 函数 - 动态生成的导出（如
export { [key]: value }）需谨慎，确保 key 不泄露内部逻辑
