萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 腳本程式專題 >> JavaScript

JSON.parse 轉義字符深度解析:雙重轉義機制與實戰避坑指南

核心問題:為什麼會有「雙重轉義」?

JSON.parse() 接收的是**字串字面值**。字串字面值在 JavaScript 引擎解析階段就會經歷**第一次轉義**;接著 JSON.parse 再對解析後的字串內容進行**第二次 JSON 標準轉義**。

兩階段轉義流程圖解

源代碼字面值          →  JS 引擎解析 (第1次)  →  實際字串內容  →  JSON.parse (第2次)  →  最終 JS 物件
'{"a":"b\\"c"}'    ───▶  {"a":"b\"c"}      ───▶  { a: 'b"c' }
   ↑                         ↑                    ↑
  寫 4 個 \               變 2 個 \            變 1 個 " (字串邊界)

詳細案例驗證

案例 1:雙引號轉義

// 目標物件:{ a: 'b"c' }
// JSON 字串標準寫法:{"a":"b\"c"}
// JS 字串字面值寫法 (需雙重轉義):
const code1 = '{"a":"b\\"c"}';   // 寫兩個 \ → 字串內容有一個 \ → JSON 解析為 "
console.log(JSON.parse(code1)); // { a: 'b"c' } ✅

// 常見錯誤:只寫一個 \
const code2 = '{"a":"b\"c"}';   // JS 語法錯誤:字串未閉合
// 或
const code3 = '{"a":"b\"c"}';   // 若用單引號包:字串內容為 b"c → JSON 解析報錯 (未轉義的 " 視為結束)

案例 2:反斜線本身

// 目標物件:{ path: 'C:\Users' }  (字串含單一反斜線)
// JSON 標準:反斜線需轉義 → "C:\\Users"
// JS 字面值:每個 \ 再轉義一次 → "C:\\\\Users"

const code = '{"path":"C:\\\\Users"}'; // 寫 4 個 \
console.log(JSON.parse(code)); // { path: 'C:\Users' } ✅

// 實際字串內容驗證
console.log('{"path":"C:\\\\Users"}'); // 輸出:{"path":"C:\\Users"} (2個\)
console.log(JSON.parse('{"path":"C:\\\\Users"}').path); // C:\Users (1個\)

案例 3:控制字元 (\n, \t, \r)

// 目標:{ msg: '第一行\n第二行' }
// JSON:\n 需轉義為 \\n
// JS 字面值:每個 \ 再轉義 → \\\\n

const code = '{"msg":"Line1\\\\nLine2"}'; // 寫 4 個 \ + n
console.log(JSON.parse(code).msg); 
// 輸出:
// Line1
// Line2

// 驗證中間字串
console.log('{"msg":"Line1\\\\nLine2"}'); // {"msg":"Line1\\nLine2"} (2個\ + n)

轉義規則總結表

目標字元JSON 標準轉義JS 字串字面值寫法實際字串內容
" (雙引號)\"\\"\"
\ (反斜線)\\\\\\\\
/ (斜線)\/ (可選)\\/\/
換行\n\\n\n
Tab\t\\t\t
回車\r\\r\r
退格\b\\b\b
換頁\f\\f\f
Unicode\uXXXX\\uXXXX\uXXXX

最佳實務:避免手寫轉義

❌ 反模式:手工拼接 JSON 字串

const json = '{"name":"' + userInput + '"}'; // 極度危險:XSS、注入、轉義錯誤

✅ 正確:用 JSON.stringify 自動處理

const obj = { name: userInput, path: 'C:\\Users', msg: 'Line1\nLine2' };
const json = JSON.stringify(obj); // 自動正確轉義
console.log(json); // {"name":"...","path":"C:\\\\Users","msg":"Line1\\nLine2"}

// 傳輸/儲存 json...
// 解析還原
const restored = JSON.parse(json);
console.log(restored.path); // C:\Users (單一反斜線)
console.log(restored.msg);  // 實際換行

✅ 從後端/檔案讀取 JSON 字串時

// 後端直接輸出標準 JSON,前端 fetch 取得 text 後直接 parse
const response = await fetch('/api/data');
const text = await response.text(); // 已是標準 JSON 字串,無需手動轉義
const data = JSON.parse(text);      // 直接解析

// 或直接
const data = await response.json(); // 內部已處理

偵錯技巧:可視化中間字串

function debugJsonParse(jsonStr) {
    console.group('JSON.parse Debug');
    console.log('1. 字面值/讀取內容:', jsonStr);
    console.log('2. 字串實際字元:', [...jsonStr].map(c => c.charCodeAt(0).toString(16)).join(' '));
    try {
        const result = JSON.parse(jsonStr);
        console.log('3. 解析成功:', result);
        console.groupEnd();
        return result;
    } catch (e) {
        console.error('3. 解析失敗:', e.message);
        console.groupEnd();
        throw e;
    }
}

總結

  • 寫代碼時:永遠使用 JSON.stringify 產出 JSON,絕不手工拼接。
  • 閱讀代碼時:看到字串字面值中的 \\\\ 代表最終 JSON 中有 \\,最終物件中有一個 \。
  • 除錯時:console.log 字串變數本身 (非字面值) 查看實際內容,再餵給 JSON.parse。
  • 記住公式:JS字面值轉義層數 = JSON標準轉義層數 + 1。
copyright © 萬盛學電腦網 all rights reserved