Proxy 仅支持代理引用类型，基本类型需包装成对象（如 {value: 42}）才能代理；解构、直接赋值、整对象替换会脱离代理层；拦截仅作用于代理对象本身，不响应原始对象变更。
JavaScript 中 Proxy 代理不是“万能胶”，它能力强大，但有明确的适用边界。用错场景不仅无效，还可能引发静默失败、无限递归或响应丢失等问题。关键是要理解哪些能代理、哪些不能，以及绕过限制的合理方式。
基本类型无法直接代理
Proxy 只接受对象、数组、Map、Set 等引用类型作为 target；number、string、boolean、null、undefined、symbol、bigint 这些基本类型传入会直接报错：TypeError: Cannot create proxy with a non-object target。
- 不能写：
new Proxy(42, handler)或reactive('hello') - 可行方案：包装成对象（如
{ value: 42 }），再代理该包装对象 - Vue 3 中已封装此逻辑——基本类型统一用
ref()，内部就是基于包装对象 + Proxy 实现
代理仅作用于目标对象本身
Proxy 拦截的是对代理对象的操作，不感知原始对象的变更，也不控制外部对原始对象的直接访问。
CPA Update - Secure CLI Proxy API Maintenance
下载
安全更新和维护 CLI Proxy API（CPA）部署与配置。用于 CPA 镜像升级、配置变更、认证目录兼容修复、上线验证与回滚。适用于用户提到“CPA 更新/升级/配置改了/容器重建/回滚”等场景。
- 错误做法：
const raw = { x: 1 }; const p = reactive(raw); raw.x = 2;→ 视图不更新 - 正确做法：所有读写必须通过代理对象
p.x = 2 - 开发中建议配合
markRaw()显式标记不应被代理的对象（如 DOM 元素、第三方类实例）
解构与赋值会脱离代理层
JavaScript 的解构、展开运算符、直接赋值等操作提取的是原始值，而非响应式引用，天然绕过 Proxy。
立即学习“Java免费学习笔记（深入）”；
- 失效示例：
const { count } = reactive({ count: 0 }); count = 1;→ 不触发更新 - 保持响应式：用
toRefs()解构，或访问state.count而非解构后的变量 - 整对象替换（
state = { ... }）也会丢掉代理，应改用属性级赋值或Object.assign(state, newValues)
陷阱（traps）覆盖不等于行为全覆盖
Proxy 提供 13 种拦截器，但多数业务场景只用到 get、set、has、ownKeys 等几个；部分操作仍受限于 JS 语言机制。
-
in操作由has拦截，但for...in和Object.keys()由ownKeys控制，二者需协同使用才能一致隐藏属性 -
get中若未正确传递receiver参数，访问原型方法时可能跳过代理，甚至引发死循环 - 数组 length 修改、稀疏数组索引设置等行为，在某些引擎中仍存在拦截盲区，不宜完全依赖 Proxy 做强一致性校验
