讲师中心 微信公众号
AI工具推荐 视频效率加速

Vue3 响应式数据如何进行深拷贝?解决引用类型数据污染的避坑指南

小晨姑娘_9565

小晨姑娘_9565

发布时间:2026-04-29 14:21:16

|

196人浏览过

|

来源于php中文网

原创

Vue3响应式数据深拷贝应优先用structuredClone(toRaw(obj)),它支持Map/Set/Date/RegExp等且解决循环引用;老环境可手动递归实现,关键要toRaw解包、WeakMap防循环、类型特判;核心是隔离变更而非单纯拷贝。

vue3 响应式数据如何进行深拷贝?解决引用类型数据污染的避坑指南

Vue3 的响应式数据不能直接用 JSON.parse(JSON.stringify()) 深拷贝,因为会丢失响应式代理、函数、undefined、Symbol、Date、RegExp 等类型,还会报错循环引用。真正安全的深拷贝,得结合数据类型、是否保留响应式、以及实际使用场景来选方案。

用 structuredClone 快速拷贝(推荐用于普通对象/数组)

现代浏览器(Chrome 98+、Firefox 94+、Safari 15.4+)已原生支持 structuredClone,它能正确处理 Map、Set、Date、RegExp、ArrayBuffer 及嵌套结构,且不丢失值类型,也支持循环引用。

示例:

const original = reactive({
  name: 'Alice',
  info: { age: 30, tags: ['vue', 'ts'] },
  created: new Date(),
  flags: new Set(['active'])
});

// ✅ 安全深拷贝(非响应式)
const cloned = structuredClone(original);

// ❌ 不要对 reactive 对象直接 structuredClone —— 会抛错(Proxy 不可克隆)
// 正确做法:先 toRaw,再克隆
const raw = toRaw(original);
const safeCloned = structuredClone(raw);

注意:structuredClone 不保留 Vue 响应式,返回的是普通 JS 对象;若需拷贝后仍响应式,需再套一层 reactive()。

立即学习“前端免费学习笔记(深入)”;

手动递归 + 类型判断(兼容老环境或需定制逻辑)

当项目需兼容低版本浏览器,或需要控制某些字段不拷贝、替换特定值、跳过 Symbol 键等,可封装轻量递归深拷贝函数,并避开 Proxy 对象(如 toRaw 后再操作)。

关键点:

Vue Wrap
Vue Wrap

Vue 入门指南 — JavaScript 框架

下载
  • 遇到 ref / reactive 代理对象,先用 toRaw() 解包
  • 跳过函数、undefined、Symbol(JSON 方法本身就不支持,手动实现也要明确策略)
  • 单独处理 Date、RegExp、Map、Set 等内置对象
  • 用 WeakMap 缓存已遍历对象,解决循环引用

简化版示例(仅示意逻辑):

function deepClone(obj, cache = new WeakMap()) {
  if (obj === null || typeof obj !== 'object') return obj;

  // 处理 Proxy(Vue 响应式对象)
  if (isReactive(obj) || isRef(obj)) {
    obj = toRaw(obj);
  }

  if (cache.has(obj)) return cache.get(obj);

  let result;
  if (obj instanceof Date) result = new Date(obj);
  else if (obj instanceof RegExp) result = new RegExp(obj);
  else if (obj instanceof Map) {
    result = new Map();
    obj.forEach((v, k) => result.set(deepClone(k, cache), deepClone(v, cache)));
  } else if (obj instanceof Set) {
    result = new Set();
    obj.forEach(v => result.add(deepClone(v, cache)));
  } else {
    result = Array.isArray(obj) ? [] : {};
    cache.set(obj, result);
    for (const key in obj) {
      if (Object.prototype.hasOwnProperty.call(obj, key)) {
        result[key] = deepClone(obj[key], cache);
      }
    }
  }
  return result;
}

避免污染:响应式数据别直接赋值引用

很多“数据污染”其实不是拷贝问题,而是误把响应式对象直接赋给了另一个响应式变量,导致双向绑定意外联动。例如:

// ❌ 危险!a 和 b 指向同一 reactive 对象
const a = reactive({ count: 1 });
const b = a; // b 不是副本,是别名
b.count = 99;
console.log(a.count); // 99 → 已被改写

正确做法:

  • 需要独立副本 → 先深拷贝(structuredClone(toRaw(a))),再 reactive()
  • 仅读取或临时计算 → 用 toRaw() 或 unref() 避免触发依赖收集
  • 表单编辑场景 → 推荐用 toRefs() + 解构 + 独立 ref 维护编辑态,提交时再合并

Pinia store 数据怎么安全拷贝?

PINIA 的 store.$state 是响应式对象,直接赋值会污染原始状态。安全做法:

  • 只读快照:用 toRaw(store.$state) 获取原始数据,再用 structuredClone 拷贝
  • 编辑副本:在组件内用 ref(structuredClone(toRaw(store.$state))) 创建独立 ref,提交时调用 store.$patch() 或重置整个 state
  • 避免 const edit = store 这类浅赋值 —— 它等于在操作原始 store

示例:

const store = useUserStore();
const editForm = ref(structuredClone(toRaw(store.$state)));

// 提交时
function onSubmit() {
  store.$patch({ ...editForm.value });
}

不复杂但容易忽略:深拷贝不是目的,隔离数据变更才是核心。优先用 toRaw + structuredClone,老环境补递归方案,关键是在赋值前想清楚——这里要的是副本,还是别名?

热门AI工具

更多
Laper
Laper Hot

Laper是专为编剧、导演和制片人推出的 AI 原生剧本创作工具。

PixPix
PixPix Hot

PixPix是一款面向电商视觉生产的AI商品图生成工具。

火山引擎

火山引擎是一款面向企业的云计算与AI服务平台。

WorkBuddy

一款AI办公效率工具,主要用于腾讯云推出的AI原生桌面智能体工作台,适合需要提升相关任务效率的用户。

切问学术

切问学术是一款AI论文写作工具,复旦大学NLP团队推出的AI学术智能体。

DeepSeek

DeepSeek是一款面向对话、写作、编程和推理场景的AI大模型工具。

PixTV
PixTV Hot

PixTV是一款面向AIGC内容创作的AI视频生成工具。

超级简历WonderCV

一款AI办公效率工具,主要用于免费求职简历模版下载制作,应届生职场人必备简历制作神器,适合需要提升相关任务效率的用户。

豆包大模型

豆包大模型是一款由字节跳动推出的企业级大语言模型服务平台。

相关专题

更多
python是前端还是后端
python是前端还是后端

Python属于前端也属于后端,其灵活性和丰富的生态系统使得开发人员能够在不同的领域中灵活运用。本专题为大家提供python相关的文章、下载、课程内容,供大家免费下载体验。

2703

2023.08.11

前端如何实现即时通讯
前端如何实现即时通讯

实现即时通讯的方法有WebSocket、Long Polling、Server-Sent Events、WebRTC等等。详细介绍:1、WebSocket,它可以在客户端和服务器之间建立持久连接,实现实时的双向通信,前端可以使用 WebSocket API来创建WebSocket连接,并通过发送和接收消息来实现即时通讯;2、Long Polling,是一种模拟实时通信的技术等等。

5883

2023.10.09

前端和后端的区别
前端和后端的区别

前端关注的是用户界面的设计和交互,而后端则注重数据处理和逻辑控制。想了解更多前端后端的相关内容,可以阅读本专题下面的文章。

6850

2024.03.19

php和前端的关联介绍
php和前端的关联介绍

php既可以作为前端语言,也可以作为后端语言。想了解更多php和前端的相关内容,可以阅读本专题下面的文章。

6598

2024.03.22

前端外包工作内容有哪些
前端外包工作内容有哪些

前端外包工作内容包括:1. 网站和应用程序开发;2. 用户界面和交互设计;3. 用户体验优化;4. 设计和视觉开发;5. 跨浏览器兼容性;6. 性能优化;7. 维护和更新;8. 项目管理和沟通。想了解更多前端的相关内容,可以阅读本专题下面的文章。

943

2024.05.22

vue2.0和3.0区别
vue2.0和3.0区别

vue2.0和3.0区别:vue2的响应式原理是利⽤“Object.defineProperty()”对数据进⾏劫持结合发布订阅模式的⽅式来实现,vue3中使⽤了es6的proxy API对数据代理,实现对数据的监控。本专题为大家提供vue2.0和3.0区别的相关的文章、下载、课程内容,供大家免费下载体验。

1714

2023.07.17

vue3的生命周期有哪些
vue3的生命周期有哪些

vue3的生命周期:1、beforecreate;2、created;3、beforemount;4、mounted;5、beforeupdate;6、updated;7、beforedestroy;8、destroyed;9、activated;10、deactivated等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

12322

2024.02.23

Vue3组合式API与组件开发实战
Vue3组合式API与组件开发实战

本专题讲解 Vue 3 组合式 API 的核心概念与应用技巧,深入分析响应式系统、生命周期管理、组件设计与复用策略。通过完整项目案例,指导前端开发者实现高性能、结构清晰的 Vue 应用,提升开发效率与代码可维护性。

316

2026.02.10

Vite 项目如何打包和部署
Vite 项目如何打包和部署

Vite项目打包部署专题汇集生产构建、产物预览、输出目录、资源路径、Nginx与GitHub Pages部署及常见白屏和路由404问题的已审核文章,帮助读者完成上线流程。

40

2026.10.28

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
uni-app快速上手
uni-app快速上手

共0课时 | 0人学习

Vue 教程
Vue 教程

共42课时 | 17.3万人学习

Vue3.x 工具篇--十天技能课堂
Vue3.x 工具篇--十天技能课堂

共26课时 | 2.5万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn