Object.assign 结合 Symbol 实现属性私有化合并方法

本文深入解析了如何利用 Symbol 与 Object.assign 协同实现“受控的属性合并”，强调 Symbol 并非语言级私有机制，而是凭借其唯一性和命名隔离特性，在工程实践中模拟约定式私有语义——它能让开发者安全地合并内部状态（如缓存、元数据）而不干扰公共属性，同时明确警示：Symbol 属性仍可被反射和显式访问，真正的私有化必须依赖 #field 或闭包；文章通过清晰示例和实用工具函数，揭示了这一模式的本质、能力边界与最佳适用场景。

Object.assign 本身无法实现真正的私有属性，因为它只复制可枚举的自有属性，而 Symbol 属性虽然具有唯一性和“隐藏性”，但仍属于**可枚举的自有属性**（只要没用 Object.defineProperty 显式设为 enumerable: false），因此会被 Object.assign 正常合并。所谓“利用 Symbol 实现私有化合并”，实质是借助 Symbol 的**命名隔离**和**不易被意外覆盖**的特性，在约定层面模拟私有语义，并控制合并行为——不是靠语言机制锁死访问，而是靠设计约束避免误用。

Symbol 属性在 Object.assign 中的行为特点

Symbol 作为属性键时，只要该属性是对象的自有属性且 enumerable === true（默认即如此），Object.assign 就会将其复制过去：

const sym = Symbol('id');
const source = { [sym]: 123, name: 'Alice' };
const target = {};
Object.assign(target, source);
console.log(target[sym]); // 123 ✅
console.log(target.name); // 'Alice' ✅

这说明 Symbol 属性并不因“是 Symbol”而被跳过——它只是不会出现在 for...in 或 Object.keys() 中，但 Object.assign 内部使用的是 getOwnPropertyNames + getOwnPropertySymbols，所以能拿到所有自有属性（含 Symbol 键）。

用 Symbol 模拟“受控私有合并”的常见模式

真正实用的做法，是把 Symbol 当作**内部标识符**，配合工厂函数或类封装，让外部不直接构造或修改这些 Symbol 属性，从而在协作中形成“约定私有”。合并时可选择性处理：

• 显式白名单合并：只合并指定 Symbol 属性，忽略其他（包括其他 Symbol 或字符串键）
• Symbol 命名空间隔离：每个模块/类定义自己的 Symbol，避免跨模块冲突
• 结合 defineProperty 控制枚举性：将 Symbol 属性设为 enumerable: false，使其不被 Object.assign 自动捕获，需手动处理

示例：带 Symbol “私有字段”的安全合并工具

以下是一个轻量工具函数，只合并预定义的 Symbol 属性（如 $$cache、$$meta），跳过普通属性，防止意外覆盖业务字段：

const $$cache = Symbol('cache');
const $$meta = Symbol('meta');

function safeMerge(target, ...sources) {
  sources.forEach(source => {
    // 只合并特定 Symbol 属性，不碰字符串键
    [$$cache, $$meta].forEach(sym => {
      if (source.hasOwnProperty(sym)) {
        target[sym] = source[sym];
      }
    });
  });
  return target;
}

const obj1 = { [$$cache]: new Map(), [$$meta]: { version: 1 } };
const obj2 = { [$$cache]: new Set(), name: 'test' }; // name 不会被合并

const result = safeMerge({}, obj1, obj2);
console.log(result[$$cache]); // Set {}（后一个覆盖前一个）
console.log(result.name);     // undefined（被忽略）

重要提醒：这不是真正的私有化

需要明确的是：

• 任何拥有该 Symbol 引用的代码，都能读写对应属性——Symbol('x') 和 Symbol('x') 是不同值，但若导出 Symbol 常量（如 export const PRIVATE_ID = Symbol('id')），模块内就可自由访问
• 无法阻止反射操作：Reflect.ownKeys(obj)、Object.getOwnPropertySymbols(obj) 都能列出 Symbol 键
• 真私有应使用 #field 语法（ES2022 私有字段）或闭包，Symbol 是“软私有”，适合内部状态标记、调试标识、框架元数据等场景

到这里，我们也就讲完了《Object.assign 结合 Symbol 实现属性私有化合并方法》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！