Proxy 是对目标对象的可编程拦截层，解决访问控制问题，如响应式、权限校验、日志等；必须传入对象 target 和 handler 对象，常用 get/set trap 需配合 Reflect 方法确保正确转发。
Proxy 是什么，它解决什么问题
Proxy 不是普通对象，而是对另一个对象的“拦截层”——你操作的是 Proxy 实例，但实际行为由你定义的 handler 控制。它不修改原对象，也不替代原对象，而是提供一层可编程的访问控制。常见用途包括：数据响应式（如 Vue 3）、权限校验、日志记录、不可变封装、属性访问兜底（类似 get 中返回默认值）。
必须传两个参数：target 和 handler
创建 Proxy 的语法固定为 new Proxy(target, handler)。漏掉任一参数都会报错：TypeError: Cannot create proxy with a non-object as target or handler。注意：target 必须是对象（含数组、函数、RegExp 等），null 或原始值（如 42、"str"）直接报错；handler 可以是空对象 {}，此时 Proxy 表现和原对象一致，但已具备扩展能力。
常见错误场景：
- 把
handler写成function而非对象 - 误将字符串或数字直接传给
target，没包装成对象 - 在
handler中忘记return Reflect.get(...)等默认转发，导致读取属性返回undefined
get 和 set 是最常用且易出错的 trap
get(target, prop, receiver) 拦截属性读取；set(target, prop, value, receiver) 拦截赋值。关键点在于：它们不会自动执行原操作，必须显式调用 Reflect.get 或 Reflect.set（推荐）来触发默认行为，否则会静默失效。
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
const obj = { count: 0 };
const p = new Proxy(obj, {
get(target, prop) {
console.log(`读取 ${prop}`);
return target[prop]; // ❌ 不推荐：绕过原型链、不支持 this 绑定
// ✅ 推荐：return Reflect.get(target, prop, p);
},
set(target, prop, value) {
if (prop === 'count' && typeof value !== 'number') {
throw new Error('count 必须是数字');
}
target[prop] = value; // ❌ 风险：跳过 setter、忽略原型上同名 setter
// ✅ 推荐：return Reflect.set(target, prop, value, p);
}
});
遗漏 receiver 参数会导致 this 指向错误，尤其在访问 getter/setter 时；用 Reflect 方法能自动透传 receiver，避免这类 bug。
Proxy 无法代理非对象，也不能劫持已有属性的 descriptor
Proxy 只能代理对象本身，对它的属性是否可枚举、是否可配置等元信息（即 Object.getOwnPropertyDescriptor 返回的内容）无感知，也无法动态修改这些 descriptor。想监听属性定义（如 Object.defineProperty）需用 defineProperty trap；想拦截 in 操作符用 has；想让 for...in 只遍历特定属性，得配合 ownKeys + getOwnPropertyDescriptor trap。
真正容易被忽略的一点：Proxy 创建后，原对象仍可被直接访问。若业务逻辑同时混用 obj 和 p，响应式或校验就会失效——你得确保所有访问都走 Proxy 实例，且不要意外暴露 target。
Java免费学习笔记：立即使用
解锁 Java 大师之旅：从入门到精通的终极指南
