JavaScript 私有成员实现方案对比：从命名约定到 Symbol 与 WeakMap 整合

前言

前言

在面向对象编程范式中，封装是核心概念之一。Java、C++ 等传统面向对象语言通过语法支持私有成员来实现封装。然而，JavaScript 在早期版本中缺乏原生的私有成员语法支持，导致开发者不得不采用各种变通方法。本文将介绍几种实现 JavaScript 私有成员的常见方案，并对比它们的优缺点。

现有的一些实现方案

现有的一些实现方案

约定命名方案

约定命名方案

该方案约定以下划线 '_' 开头的成员名作为私有成员，仅允许类内部方法访问，外部禁止访问。示例代码如下：

JavaScript

var MyClass = function () {
  this._privateProp = ‘privateProp';
};
MyClass.prototype.getPrivateProp = function () {
  return this._privateProp;
};
var my = new MyClass();
alert(my.getPrivateProp()); // ‘privateProp';
alert(my._privateProp); // 并未真正隐藏，依然弹出 ‘privateProp'

优点

约定命名是最简单的实现方式，无需额外代码逻辑。调试时可直接在控制台查看对象上的私有成员，便于问题排查。此外，该方案兼容性极佳，支持 IE6 及以上版本浏览器。

不足

此方案无法真正阻止外部访问或修改私有成员。若有开发者无视约定直接修改属性，系统无法进行限制。虽然通过代码规范团队可以强制遵守，但这依赖于人为约束而非语言机制。

es6 symbol 方案

es6 symbol 方案

ES6 引入了 Symbol 类型，其初衷之一便是支持私有成员。核心思路是为每个私有成员生成一个随机且唯一的字符串 key，该 key 对外不可见，对内通过闭包变量访问。示例代码如下：

JavaScript

(function() {
   var privateProp = Symbol(); // 每次调用会产生一个唯一的key
   function MyClass() {
     this[privateProp] = ‘privateProp'; // 闭包内引用到这个 key
   }
   MyClass.prototype.getPrivateProp = function () {
     return this[privateProp];
   };
})();
var my = new MyClass();
alert(my.getPrivateProp()); // ‘privateProp';
alert(my.privateProp); // 弹出 undefined，因为成员的key其实是随机字符串

优点

Symbol 方案弥补了命名约定的缺陷，外部无法通过常规途径获取私有成员的访问权。调试方面，若为 Symbol 构造函数传入字符串参数，控制台会显示为 Symbol(key)，调试体验尚可接受。

该方案兼容性良好，不支持 Symbol 的旧浏览器可通过 shim 方式实现兼容。

不足

写法较为繁琐，需为每个私有成员创建闭包变量供内部方法访问。此外，外部仍可通过 Object.getOwnPropertySymbols 获取实例的 Symbol 属性名，进而访问私有成员。不过，知晓此途径的开发者通常具备足够能力评估其行为影响，因此这一缺陷在实际应用中影响有限。

es6 WeakMap 方案

es6 WeakMap 方案

ES6 引入了 Map 和 WeakMap 容器，其特点是键名可为任意数据类型。虽然初衷并非专为私有成员设计，但可被巧妙用于实现该特性。

核心思路是在类级别创建 WeakMap 容器存储各实例的私有成员。该容器对外不可见，对内通过闭包可见；内部方法以实例为键名从容器中获取对应私有成员。示例代码如下：

JavaScript

(function() {
   var privateStore = new WeakMap(); // 私有成员存储容器
   function MyClass() {
     privateStore.set(this, {privateProp: ‘privateProp'}); // 闭包内引用到privateStore, 用当前实例做 key，设置私有成员
   }
   MyClass.prototype.getPrivateProp = function () {
     return privateStore.get(this).privateProp; 
   };
})();
var my = new MyClass();
alert(my.getPrivateProp()); // ‘privateProp';
alert(my.privateProp); // 弹出 undefined，实例上并没有 privateProp 属性

优点

弥补了命名约定方案的缺陷，外部无法通过正常途径获得私有成员的访问权。 对 WeakMap 做一些封装，抽出一个私有特性的实现模块，可以在写法上相对 Symbol 方案更加简洁干净，其中一种封装的实现可以查看参考文章3。 最后一个是个人认为最大的优势：基于 WeakMap 方案，可以方便的实现保护成员特性（这个话题会在其他文章说到：））

不足

调试困难，因私有成员位于闭包容器内，无法在控制台直接打印实例查看私有成员。关于性能，据 ES6 邮件列表讨论，WeakMap 内部可能通过顺序对比定位 key，时间复杂度为 O(n)，相比哈希算法的 O(1) 较慢。

最大缺陷在于兼容性导致的内存膨胀问题。在不支持 WeakMap 的浏览器中，无法实现弱引用特性，导致实例无法被垃圾回收。例如，若私有成员包含大数据项，无弱引用时将造成内存泄露。

现有实现方案小结

现有实现方案小结

对比上述方案，Symbol 方案的最大优势在于易于模拟实现；WeakMap 方案的优势在于支持保护成员。现阶段 WeakMap 无法模拟弱引用导致的内存问题是其难以接受的缺陷。因此，思路转向结合两者优势的方案。

Symbol + 类WeakMap 的整合方案

Symbol + 类WeakMap 的整合方案

WeakMap 方案的主要问题是无法 shim 弱引用，次要问题是不便调试。

Shim 出的 WeakMap 无法追溯实例生命周期，而实例上的私有成员生命周期依赖于实例。因此，将实例级别的私有成员部分置于实例上，实例销毁后属性随之销毁。私有存储区域的隐藏则使用 Symbol 实现。

该方案提供 createPrivate 函数，返回私有 token 函数。该函数对外不可见，对内通过闭包获取，传入当前实例可返回其私有存储区域。使用方式如下：

JavaScript

(function() {
   var $private = createPrivate(); // 私有成员 token 函数，可以传入对象参数，会作为原型链上的私有成员
   function MyClass() {
     $private(this).privateProp = ‘privateProp' ; // 闭包内引用到privateStore, 用当前实例做 key，设置私有成员
   }
   MyClass.prototype.getPrivateProp = function () {
     return $private(this).privateProp; 
   };
})();
var my = new MyClass();
alert(my.getPrivateProp()); // ‘privateProp';
alert(my.privateProp); // 弹出 undefined，实例上并没有 privateProp 属性

代码核心在于实现 createPrivate 函数，大致实现如下：

JavaScript

// createPrivate.js
function createPrivate(prototype) {
  var privateStore = Symbol('privateStore');
  var classToken = Symbol(‘classToken');
  return function getPrivate(instance) {
     if (!instance.hasOwnProperty(privateStore)) {
       instance[privateStore] = {};
     }
    var store = instance[classToken];
     store[token] = store[token] || Object.create(prototype || {});
     return store[token];
   };
}

上述实现采用两层存储：privateStore 为实例上统一的私有成员存储区域，classToken 对应继承层次中不同类的私有成员定义。基类与子类的私有成员区域相互独立。

若仅做一层存储也可实现，两层存储主要为了调试方便，可通过控制台 Symbol('privateStore') 属性查看实例各层次的私有部分。

奇葩的 es5 property getter 拦截方案

奇葩的 es5 property getter 拦截方案

该方案利用 ES5 提供的 getter，通过 argument.callee.caller 判断调用场景。若为外部调用则抛出异常或返回 undefined，内部调用则返回真实私有成员。实现复杂且不支持严格模式，不推荐使用，有兴趣者可参考具体实现。

总结

总结

综合对比，个人倾向于 Symbol 与 WeakMap 的整合方案，它结合了两者的优点，弥补了 WeakMap 的不足及 Symbol 书写的冗余。随着 JavaScript 发展，私有成员和保护成员终将在语法层面得到支持，如 ES6 对 class 关键字和 super 语法糖的支持。现阶段仍需开发者利用技巧填补语言特性空白。

Javascript私有成员的实现方式

Javascript私有成员的实现方式

总体而言，相关书籍内容尚可，但阅读后仍存疑问，如 JS 中私有变量的实现及 prototype 等。经过一系列测试，现已明确相关机制。

许多书籍指出，JavaScript 无法真正实现私有成员，因此开发时统一约定以两个下划线 __ 开头的变量为私有变量。

随后发现，利用 JavaScript 的闭包特性，可彻底解决私有成员的实现问题。

 function testFn(){ 
    var _Name;//定义Javascript私有成员 
    this.setName = function(name){ 
     _Name = name; //从当前执行环境中获取_Name 
    } 
    this.getName = function(){ 
     return _Name; 
    } 
}// End testFn 
var test = testFn(); 
alert(typeof test._Name === "undefined")//true 
test.setName("KenChen"); 

test._Name 无法直接访问，但通过对象方法可访问，因为闭包能从当前执行环境中获取信息。

接下来我们看看，共有成员是怎样实现的

function testFn(name){ 
  this.Name = name; 
  this.getName = function(){ 
   return this.Name; 
  } 
} 
var test = new testFn("KenChen"); 
test.getName(); //KenChen 
test.Name = "CC"; 
est.getName();//CC 

接下来在看看类静态变量是怎样实现的

function testFn(){ 
} 
testFn.Name = "KenChen"; 
alert(testFn.Name);//KenChen 
testFn.Name = "CC"; 
alert(testFn.Name);//CC