Proxy 是 JavaScript 中唯一能拦截并自定义对象基本操作的机制；它通过 handler 对象定义 get、set 等拦截函数，需显式实现逻辑，否则透传；无法自动深度代理嵌套对象，且必须用 Reflect 委托默认行为以避免语义破坏。
Proxy 不是语法糖，也不是可选的包装器——它是 JavaScript 中唯一能拦截并自定义对象基本操作（比如读取、赋值、in 判断、函数调用）的机制。 没有 Proxy，你就无法真正“监听”一个普通对象的 obj.x 访问，也无法让 delete obj.y 返回 false 或触发副作用。
代理对象的核心：handler 里写拦截逻辑
创建 Proxy 必须传入两个参数：目标对象（target）和处理器对象（handler）。handler 是个普通对象，键名是固定的操作名（如 get、set、has、apply），每个键对应一个拦截函数。
常见错误是把 handler 写成空对象：new Proxy(obj, {}) —— 这不会报错，但所有操作都透传，等于没代理。必须显式定义要拦截的行为。
-
get(target, prop, receiver)：拦截读取。注意第三个参数receiver通常是 proxy 本身，用于正确绑定this（尤其在访问 getter 时） -
set(target, prop, value, receiver)：拦截赋值。必须返回true才算成功，否则抛TypeError -
has(target, prop)：拦截prop in proxy，返回布尔值 -
ownKeys(target)：拦截Object.getOwnPropertyNames(proxy)等，必须返回数组，且内容需与getOwnPropertyDescriptor一致
为什么不能直接代理普通对象做响应式？
Vue 2 的响应式基于 Object.defineProperty，而 Vue 3 改用 Proxy，根本原因在于能力边界：
使用 ImageMagick 的 convert 和 mogrify 命令进行批量图像处理，支持调整大小、裁剪、水印和格式转换。与 libvips 集成以实现高性能缩略图生成。
立即学习“Java免费学习笔记（深入）”；
-
Object.defineProperty无法监听属性新增或删除（obj.newProp = 1或delete obj.x） -
Proxy可以通过set和deleteProperty拦截这两类操作 - 但
Proxy无法 deep 代理嵌套对象——你代理了obj，但obj.nested还是原生对象，除非手动递归代理（或用Reflect.get+ 判断返回值是否 object 再 wrap） -
Proxy代理的是引用，不是值；对数组索引赋值（arr[0] = 1）能被set拦截，但arr.push()这类方法调用需单独在get中拦截并包装方法
实际用法示例：带校验的只读视图
下面这个例子创建一个“只读 + 类型校验”的代理，对数字字段强制转为 number，非数字则拒绝写入：
const data = { count: 0, name: 'test' };
const validatedReadOnly = new Proxy(data, {
set(target, prop, value) {
if (prop === 'count' && typeof value !== 'number') {
console.warn(`count must be number, got ${typeof value}`);
return false; // 拦截失败
}
if (Object.isFrozen(target)) return false;
target[prop] = value;
return true;
},
deleteProperty() {
return false; // 完全禁止 delete
}
});
注意：这里没实现 get，所以读取仍走原逻辑；但如果你希望读取时也转换类型（比如把 '123' 自动转成 123），就得加 get 并用 Reflect.get 做默认行为委托。
Proxy 的陷阱不在语法，而在它的“透明性”——它看起来像原对象，但行为可能被任意篡改；一旦 handler 里忘了用 Reflect.xxx 委托默认行为（比如在 get 里漏掉 return Reflect.get(...)），就容易导致功能丢失或 this 绑定异常。真正难的从来不是写一个 Proxy，而是确保它在所有边界场景下不破环原有语义。
