本文深入解析 node.js commonjs 模块系统中对象/数组导出时“重赋值不生效、原地修改才同步”的根本原因，通过内存引用机制和代码示例阐明模块间变量共享的本质。
本文深入解析 node.js commonjs 模块系统中对象/数组导出时“重赋值不生效、原地修改才同步”的根本原因，通过内存引用机制和代码示例阐明模块间变量共享的本质。
在 JavaScript 的 CommonJS 模块系统（如 Node.js）中，module.exports 导出的是值的引用快照，而非实时绑定的响应式属性。当一个模块导出一个变量（如 list）时，其他模块通过 require() 获取的是该变量当前指向的内存地址的副本——这决定了后续行为的关键差异。
? 核心原理：引用 vs 重赋值
- ✅ 原地修改（mutating）：调用 list.push("item") 或 list.length = 0 等操作，直接修改堆内存中该数组对象的内容。所有持有该引用的模块（包括 test.js 中解构出的 list）都指向同一对象，因此能立即看到变化。
- ❌ 变量重赋值（reassignment）：执行 list = ["item"] 时，index.js 内部的 list 变量被重新绑定到一个全新的数组对象上。但 test.js 中解构得到的 list 仍牢牢指向原始空数组（即模块首次导出时的引用），二者自此断开关联。
我们可通过简化模型验证这一行为：
// 模拟模块导出逻辑
let list = []; // 原始数组，地址假设为 0x100
const exported = {
list, // 导出的是 0x100 的引用
add: () => {
// list = ["item"]; // ❌ 创建新数组（如 0x200），仅改变 index.js 内部 list 的指向
list.push("item"); // ✅ 修改 0x100 对象内容，exported.list 和外部引用均可见
}
};
// test.js 模拟：解构获取引用副本
let { list: importedList } = exported;
console.log(importedList === exported.list); // true → 同一引用（0x100）
exported.add();
console.log(importedList.length); // 1 → 因为 push 修改了 0x100
// 若用 list = ["item"]，则 importedList 仍为 []，长度保持 0? 正确实践建议
-
优先使用不可变模式或封装访问
避免直接导出可变基础变量。推荐将状态封装在函数或类中，通过方法控制变更：// index.js let list = []; module.exports = { add: () => list.push("item"), get: () => [...list], // 返回副本，防止外部意外修改 size: () => list.length }; 若必须导出变量，请确保使用者理解引用语义
文档中明确标注：“此数组需通过 .push() / .pop() 等方法修改，直接赋值将导致模块内外状态不同步”。ESM 场景注意差异
虽然本例基于 CommonJS，但 ES6 modules（export let list = []）中，let 声明的顶层绑定是实时绑定（live binding），重赋值 list = [...] 在 ESM 中会同步更新导入方 —— 但这仅适用于 export/import 语法，且不适用于解构导入（import { list } from './index.js' 仍是只读绑定）。CommonJS 无此特性。
✅ 总结
C. list length 0 的输出并非 Bug，而是 JavaScript 引用语义与 CommonJS 模块导出机制共同作用的必然结果。模块导出的是值的引用，不是变量本身的双向绑定。要实现跨文件状态同步，请坚持原地修改（mutate）共享对象，或采用更健壮的状态管理方案（如事件总线、单例服务、或现代状态库）。理解这一底层机制，是编写可维护模块化 JavaScript 的关键基础。
