在JavaScript中，Proxy和Reflect是ES6引入的一对用于元编程的核心工具。Proxy允许我们创建一个对象的代理，从而拦截并重新定义该对象的基本操作，例如属性读取、赋值、函数调用等；Reflect则提供了一组静态方法，用来以函数形式调用那些被Proxy拦截的默认行为。将两者结合，可以在不修改原对象代码的情况下，为其附加日志、校验、缓存等通用能力。
一、Proxy与Reflect基础原理
Proxy的构造函数接收两个参数：目标对象target和处理器对象handler。handler中可定义多种陷阱（trap），例如get、set、has、apply等。每当对这些基本操作发生时，如果handler中有对应陷阱，就会先执行陷阱逻辑。Reflect上的同名方法则用于触发目标对象的默认行为，保证语义一致。
为什么需要Reflect而不是直接在陷阱里写原生操作？因为像delete obj[key]这样的操作在严格模式下可能抛错，而Reflect.deleteProperty(obj, key)始终返回布尔值表示成功与否，更利于控制流程。此外，Reflect的方法参数顺序与Proxy陷阱完全一致，二者配合能避免this绑定错误。
// 基础示例：用 Proxy 和 Reflect 拦截属性读写
const target = {
name: 'default',
age: 18
};
const handler = {
get(obj, key, receiver) {
console.log('读取属性:', key);
return Reflect.get(obj, key, receiver);
},
set(obj, key, value, receiver) {
console.log('设置属性:', key, '为', value);
return Reflect.set(obj, key, value, receiver);
}
};
const proxy = new Proxy(target, handler);
proxy.name; // 输出：读取属性: name
proxy.age = 20; // 输出：设置属性: age 为 20
二、实战场景：属性访问保护与类型校验
在团队协作开发中，对象属性被意外赋值为错误类型是常见的bug来源。通过Proxy的set陷阱，我们可以在赋值前统一校验类型，拒绝不合法写入，而业务逻辑层完全无感知。Reflect.set负责在校验通过后执行真实赋值。
下面的例子定义了一个要求age必须为数字且非负的用户对象代理。若传入字符串或负数，代理会打印错误并阻止写入，原对象保持不变。这种方式比在每一个setter里写判断要集中得多，也方便后续增加新规则。
function createUserGuard(user) {
const handler = {
set(obj, key, value, receiver) {
if (key === 'age') {
if (typeof value !== 'number' || value < 0) {
console.error('age 必须是非负数字');
return false;
}
}
if (key === 'name' && typeof value !== 'string') {
console.error('name 必须是字符串');
return false;
}
return Reflect.set(obj, key, value, receiver);
}
};
return new Proxy(user, handler);
}
const user = createUserGuard({ name: 'Tom', age: 25 });
user.age = '30'; // 输出错误，写入失败
user.age = 28; // 正常写入
console.log(user.age);
这种校验代理还可以叠加使用。例如先套一层类型校验，再套一层变更日志，每一层只关心自己的横切关注点。由于Proxy返回的是新对象，原对象仍可单独使用，测试时也能轻易绕过代理直接断言原始数据。
三、函数调用的拦截与性能监控
除了数据属性，Proxy的apply陷阱可以包裹函数，在调用前后插入逻辑。结合Reflect.apply，我们能完整传递this和参数，不影响原函数语义。典型用途包括方法耗时统计、调用次数限制、权限检查等。
以下代码展示了一个通用计时代理工厂。任何传入的函数被调用时，都会记录开始与结束时间，并输出耗时。由于Reflect.apply正确处理了上下文，即使原函数是对象方法也不会丢失this。
function withTiming(fn) {
return new Proxy(fn, {
apply(target, thisArg, args) {
const start = Date.now();
const result = Reflect.apply(target, thisArg, args);
const end = Date.now();
console.log('函数执行耗时:', end - start, 'ms');
return result;
}
});
}
const slowAdd = (a, b) => {
for (let i = 0; i < 1e6; i++) {}
return a + b;
};
const timedAdd = withTiming(slowAdd);
console.log(timedAdd(1, 2));
在真实项目中，可以把这类代理做成装饰器，批量附加到多个服务方法上。相比手动在每一个函数里写console.time，元编程方案让监控代码与业务代码彻底分离，重构时只需调整handler。
四、用Reflect优化陷阱中的默认行为
不少初学者在写get陷阱时习惯直接返回obj[key]，但这会绕过receiver，导致原型链上的Proxy失效。使用Reflect.get(obj, key, receiver)能把receiver传递下去，保证嵌套代理也能被正确拦截。
我们通过一个继承场景说明。子对象通过Proxy代理，父类也通过Proxy代理，若get中不用Reflect而用直接取值，访问子类继承的属性就不会触发父类代理。改用Reflect后，整条原型链上的拦截器都能生效，真正实现透明的元编程层。
const parent = new Proxy({ greet: 'hi' }, {
get(obj, key, receiver) {
console.log('parent get:', key);
return Reflect.get(obj, key, receiver);
}
});
const child = new Proxy(Object.create(parent), {
get(obj, key, receiver) {
console.log('child get:', key);
return Reflect.get(obj, key, receiver);
}
});
console.log(child.greet);
// 依次输出 child get: greet、parent get: greet、hi
可以看出，Reflect不仅是调用默认行为的工具，更是维持代理链完整性的关键。在编写任何陷阱时，都应优先使用Reflect对应方法而非语言原操作符，以减少隐蔽bug。
五、总结与落地建议
Proxy与Reflect组成的元编程模式，适合处理横跨多个模块的公共逻辑，如校验、日志、缓存、权限。它们以非侵入方式增强对象与函数，保持业务代码简洁。实际落地时，建议将handler逻辑封装为可组合工厂，按需求层层包裹，并配合单元测试验证陷阱行为。
需要注意，Proxy无法代理某些内置对象（如Symbol注册表）的全部语义，且在极端性能敏感路径中陷阱会带来微小开销。因此应将其用在边界清晰的基础设施层，而非热循环内部。理解二者协作原理后，便能从容设计更优雅的JavaScript底层工具。
ProxyReflectmeta_programming修改时间：2026-08-03 13:24:30