编码/解码

JSON 字符串转义

普通字符串与 JSON 转义(\n \" \uXXXX)互转

原始字符串
JSON 转义结果

什么是 JSON 字符串转义?

在 JSON 中,字符串内的换行、引号等需转义为 \n、\" 等。本工具实现普通字符串与 JSON 转义形式的互转。

使用场景

  • 手写或粘贴 JSON 字符串时转义特殊字符
  • 日志、接口中的转义串还原为可读文本

把文本里的双引号、反斜杠和控制字符写成 JSON 字符串字面量要求的转义,也把 \n、\uXXXX 还原成真实字符。适合写进 JSON 字段值之前核对,或读取日志里被转义过一次乃至两次的串。

RFC 8259 只强制三类字符转义

在 JSON 字符串内部,RFC 8259 第 7 节只禁止三样东西:双引号、反斜杠,以及 U+0000 到 U+001F 共 32 个控制字符。其中 5 个有简写,即 \b \t \n \f \r,其余 27 个必须写成四位十六进制的 \u00XX;汉字、emoji 与正斜杠都可原样出现。坑在「多转」:JavaScript 认而 JSON 不认的 \x41、\0 会被判为非法转义。

先处理反斜杠,否则会转义两次

替换顺序决定结果对不对。若先把换行改成 \n 再处理反斜杠,刚写入的反斜杠会被再转一次,\n 退化成 \\n,JSON 读到的是反斜杠加字母 n 而不是换行。正确顺序是先反斜杠、再引号、最后其余控制字符;还原方向同理,必须一次扫描完成,才能让 \\n 与 \n 保持区分。嵌套同理:整份 JSON 存进字符串值时引号与反斜杠全部翻倍,再转一次仍能解析,换行却已丢失。

还原方向:单次扫描、四位十六进制、孤立代理项

解码是一条正则:反斜杠后面跟 " \ / b f n r t 之一,或跟 u 加恰好四位十六进制。因此 \x41 或结尾孤立的反斜杠被静默放过,不像 JSON.parse 那样报错。u 分支按 UTF-16 码元逐个转字符,\ud83d\ude00 能拼回 😀,\ud83d 单独出现则留下孤立代理项,输出时变成 U+FFFD。

实操示例

还原一条带制表符和两处中文转义的 Windows 路径

输入
C:\\Users\\dev\\app\t\u4e2d\u6587
输出
C:\Users\dev\app	中文

输入是字符串内容而不是 JSON 文档:四组双反斜杠各自折成单个反斜杠,\t 变成一个真实的制表符字节,\u4e2d\u6587 还原为「中文」。输入 33 个字符,输出 19 个。扫描只走一遍,还原中生成的反斜杠不会被二次解释,\\t 与 \t 的差别就来自这里。

边界与常见误用

  • 转义模式只输出字符串内容,不带外层双引号;直接当作 JSON 值粘贴会解析失败,需自己补上一对 "。
  • 编码方向不会把汉字改写成 \uXXXX,中文一律原样输出;若链路对 UTF-8 不可靠,需要另做一次 unicode 转义。
  • 组件没有输入长度上限,每次按键都对整块文本同步重算,粘贴几 MB 的单行日志会让面板卡住。
  • 还原模式对无法识别的转义(\x41、结尾孤立的 \)原样输出且不报错,容易把「没解开」误当成「已解开」。
  • U+0008 是唯一简写为 \b 的控制字符,而这个写法与正则的词边界记号同名,退格必须按字面码点匹配;结果在交付前用 JSON.parse 回读校验。

相关工具

六种都叫「帮我把这个字符串转义一下」的活儿,各自该走哪条路

你最终要拿到的东西本页的 JSON 字符串转义这种时候换个做法更省事
一个能直接粘进 .json 文件的值编码只给内容、不给外壳:输入 Hello,右边是一串没有外层引号的转义文本,复制按钮复制的也是它。要粘进文件还得自己补一对 ",漏了就是下游解析报错。浏览器控制台或 Node 里,JSON.stringify("Hello") 返回的是连引号一起的成品字面量。要整段值就用它;只是在手工拼接字符串、只需要里面那部分转义文本时,留在本页更顺手。
确认转义完这段还是合法 JSON面板没有报错通道:还原时遇到 \x41 或结尾孤立的 \ 一律原样吐出,编码方向对任何输入都不会失败。右边有内容,只说明工具跑完了。交给解析器判断:JSON.parse('"' + 转义结果 + '"') 会抛出并指出出错位置,JSON 格式化页还能把这段文本连上下文一起排出来看。校验归解析器,改写归本页。
把日志行里的 \u4e2d\u6587 和 \n 读成人话还原是整行一次正则扫描,\n、\" 和四位 \uXXXX 混在同一行也一次全解开;代价是解不开的序列不会提示。只需要解 \uXXXX、而字面的 \n 必须保持两个字符时,用 Unicode 转义工具:它只碰 \u 和 \U。判断标准就一句——反斜杠加 n 该不该变成真换行。
结果要过只吃 7-bit 的链路(LDAP DN、老网关)非 ASCII 一律原样输出:中文还是中文,emoji 还是 emoji。编码只改写引号、反斜杠和 32 个控制字符,所以这页产不出纯 ASCII 的结果。Unicode 转义工具的 UTF-16 模式把每个码元写成 \uXXXX;Python 里 json.dumps(s, ensure_ascii=True) 得到同样的形态。一旦确定链路会破坏 UTF-8,就该换工具而不是继续调参数。
整份文档要塞进一个字符串字段一次粘贴、一个方向、一次复制:.json 文档进来,转义文本出去,外层引号仍然缺。中间任何一步错了,都要等下游解析时才暴露。jq -Rs . < payload.json 把文件当原始文本读入,直接打印带引号、换行已转义的完整字面量。输入本来就是文件时,命令行是一步,本页要三步。
一次处理四十个字段(表格导出)只有一个输入框,没有文件选择、没有批量列表、没有列模式。四十个值就是四十轮粘贴加复制,而且每次按键都整体同步重算。十来行 Node 或 Python 遍历这份导出即可——rows.map(r => JSON.stringify(r)) 或 json.dumps(row)——一遍跑完,结果还能和原行对齐。重复劳动交给脚本。

本工具写得出、也读得回的全部转义,逐字符对照

字符(码点)编码模式的输出还原模式解成什么
双引号 "(U+0022)\"双引号本身,U+0022
反斜杠 \(U+005C)\\单个反斜杠,U+005C
换行 LF(U+000A)\n一个真实的 0x0A 字节,面板里就是真的换行
回车 CR(U+000D)\r一个真实的 0x0D 字节
制表 TAB(U+0009)\t一个真实的 0x09 字节
换页 FF(U+000C)\f一个真实的 0x0C 字节
退格 BS(U+0008)\u0008,四位小写十六进制U+0008;反向输入时 \b 也认
垂直制表 VT(U+000B)\u000bU+000B;\v 不认
正斜杠 /(U+002F)原样保留 //;输入里的 \/ 也解成 /
其余 C0 控制字符(U+0000–U+001F)\u00xx,十六进制小写对应码点;输入写成大写的 \u001F 同样认
任意非 ASCII 字符(中、😀)原样输出,不做转义原样返回
\x41、\u41、\U0041编码方向不会产生这几种一个字符都不动,且不提示

前六行都是一进二出:一个字符写成两个,还原时再收回一个。U+0008 是唯一例外——编码里那一步写的是 /\b/g,而它在正则中表示零宽词边界断言,不是 U+0008 这个码点;于是字母、数字、下划线与其它字符的每个交界处都会被插进一个字面的 \b:Hello 编码出来是 \bHello\b,真正的退格反倒落到最后的控制字符分支、变成 \u0008。不含拉丁字母的文本(如 中文)才会原样通过。十六进制恒为四位小写,是 \u000b 而不是 \u000B。

常见问题

JSON 转义和 URL 编码有什么区别?
JSON 转义解决"字符在 JSON 字符串字面量里的写法":引号写成 \"、换行写成 \n、控制字符写成 \uXXXX。URL 编码解决"字符在 URL 里如何传输"(%20 形式)。把 JSON 放进 URL 参数时两者常需叠加:先 JSON 转义、再 URL 编码。
为什么中文有时被转成 \uXXXX,有时保持原样?
JSON 标准允许两种写法,语义完全等价。保持原样(UTF-8 直出)文件更小、可读性好;转成 \uXXXX 可以避免传输链路上的编码问题。老系统的 API 若出现中文乱码,试试开启 unicode 转义选项。
哪些字符在 JSON 里必须转义?
强制的有:\"、\\,以及 U+0000–U+001F 的控制字符(其中 \n、\r、\t 有简写形式,其余必须写 \u00XX)。正斜杠 / 不需要转义,转了也合法。

内容复核: