如何理解 Symbol 属性拷贝:为什么 JSON 方法会静默丢弃所有的 Symbol 键名

风明小哥_4054

风明小哥_4054

2026-05-03

452人浏览

原创

symbol属性在json序列化中被完全忽略,因json标准(rfc 8259)仅支持七种类型且要求对象键必须为字符串,而symbol是javascript独有的不可枚举非字符串类型,既不进入遍历队列也不触发replacer回调。

如何理解 symbol 属性拷贝:为什么 json 方法会静默丢弃所有的 symbol 键名

Symbol 属性在 JSON 序列化中被完全忽略,不是因为实现疏漏,而是由 JSON 标准本身决定的——它根本不支持 Symbol 类型。

JSON 规范不承认 Symbol

JSON(RFC 8259)只定义了七种合法数据类型:null、布尔值、数字、字符串、数组、对象、以及 null(重复强调是因对象键必须为字符串)。Symbol 是 JavaScript 引入的原始类型,用于创建唯一、不可枚举(默认)且非字符串的键名,天然超出 JSON 能表达的范围。因此,JSON.stringify() 在遍历对象属性时,根本不会把 Symbol 键纳入处理队列——连“丢弃”的动作都谈不上,是直接跳过。

Json Schema Toolkit
Json Schema Toolkit

使用 JSON Schema 验证 JSON 数据,从示例 JSON 生成 schema,并将其转换为 TypeScript 接口、Python 数据类或 Markdown 文档。

下载

Symbol 键不会进入 replacer 回调

即使你传入 replacer 函数试图干预,它也收不到 Symbol 键的信息。这是因为 JSON.stringify() 的内部遍历逻辑只枚举对象上可枚举的字符串键属性(等价于 for...in + hasOwnProperty + typeof key === 'string'),而 Symbol 键既不可枚举(除非显式用 Object.defineProperty 设为 enumerable: true),又不是字符串,所以 replacer 完全感知不到它们的存在。

Symbol 值同样被静默过滤

  • 如果 Symbol 作为属性值(如 { x: Symbol('id') }),该属性会被整个忽略,结果变成 {}
  • 如果 Symbol 出现在数组中(如 [1, Symbol('a'), 3]),对应位置会转为 null(注意:这是值的处理,和键不同)
  • undefined 和函数值也按类似逻辑被剔除或转 null,但 Symbol 键的“隐身”是最彻底的——连痕迹都不留

想保留 Symbol 语义?得绕开 JSON

没有通用的自动方案。常见做法包括:

  • 序列化前手动提取 Symbol 键,用其 description 构造字符串键暂存(例如 { $$sym_b: 2 }),反序列化后再还原
  • 在对象上定义 toJSON() 方法,预先将 Symbol 相关数据映射为 JSON 可表达的结构
  • 改用其他序列化机制,如 structuredClone()(支持 Symbol,但不支持函数、循环引用等)、MessageChannel(浏览器环境)、或自研二进制/文本协议

相关专题

更多
json数据格式
json数据格式

JSON是一种轻量级的数据交换格式。本专题为大家带来json数据格式相关文章,帮助大家解决问题。

2023.08.07

2035

5

json是什么
json是什么

JSON是一种轻量级的数据交换格式,具有简洁、易读、跨平台和语言的特点,JSON数据是通过键值对的方式进行组织,其中键是字符串,值可以是字符串、数值、布尔值、数组、对象或者null,在Web开发、数据交换和配置文件等方面得到广泛应用。本专题为大家提供json相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.23

2922

1

jquery怎么操作json
jquery怎么操作json

操作的方法有:1、“$.parseJSON(jsonString)”2、“$.getJSON(url, data, success)”;3、“$.each(obj, callback)”;4、“$.ajax()”。更多jquery怎么操作json的详细内容,可以访问本专题下面的文章。

2023.10.13

996

3

go语言处理json数据方法
go语言处理json数据方法

本专题整合了go语言中处理json数据方法,阅读专题下面的文章了解更多详细内容。

2025.09.10

3299

7

LLVM自定义Pass怎么写
LLVM自定义Pass怎么写

本专题聚焦LLVM自定义Pass开发,整理Pass类结构、run()方法、PreservedAnalyses、CMake构建、插件注册、-load-pass-plugin加载和测试用例编写流程。

2026.09.30

80

10

LLVM RISC-V参数配置教程
LLVM RISC-V参数配置教程

本专题介绍LLVM对RISC-V基础ISA和扩展的支持方式,涵盖RV32、RV64、标准扩展、实验性扩展、厂商扩展、-menable-experimental-extensions和版本差异。

2026.09.30

80

14

LLVM IR中间表示入门指南
LLVM IR中间表示入门指南

本专题整理LLVM IR的核心概念,包括中间表示作用、模块结构、函数、基本块、SSA形式、类型系统和常见语法,帮助新手理解LLVM编译流程中的关键层。

2026.09.30

80

12

PDF转图片方法
PDF转图片方法

需要把 PDF 页面用于上传、预览、分享或图片归档时,PDF 转图片方法专题整理 JPG/PNG 格式选择、逐页导出、清晰度设置、批量下载和结果检查等流程,帮助用户稳定完成 PDF 图片化处理。

2026.09.30

60

26

PixTV AI视频生成与无限画布创作
PixTV AI视频生成与无限画布创作

PixTV专题整理AI视频与视觉内容创作相关功能使用教程,涵盖AI生图、视频生成、无限画布、多模型创作、素材管理、声音音乐及视频剪辑等功能,帮助用户快速掌握PixTV从创意到成片的完整制作方法。

2026.09.29

60

15

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
WEB前端教程【HTML5+CSS3+JS】
WEB前端教程【HTML5+CSS3+JS】

共101课时 | 20.8万人学习

JS进阶与BootStrap学习
JS进阶与BootStrap学习

共39课时 | 4.8万人学习