JSON String Escape

Что такое экранирование строк JSON?

Экранирование строк JSON — это процесс преобразования специальных символов внутри строки в escape-последовательности, которые JSON-парсеры могут прочитать без нарушения структуры. Спецификация JSON (ECMA-404 / RFC 8259) требует, чтобы определённые символы внутри строковых значений предварялись обратным слешем. Без правильного экранирования буквальная двойная кавычка или перевод строки внутри строки прерывали бы её досрочно и вызывали ошибку разбора.

Каждая строка JSON ограничена двойными кавычками. Когда сама строка содержит двойную кавычку, обратный слеш или управляющий символ (U+0000 — U+001F), символ должен быть заменён его escape-последовательностью. Например, буквальный перевод строки становится \n, табуляция — \t, а двойная кавычка — \". Любую кодовую точку Unicode можно также представить как \uXXXX, где XXXX — четырёхзначное шестнадцатеричное значение.

Снятие экранирования (обратная операция) преобразует эти последовательности с обратным слешем обратно в исходные символы. Используйте её, когда получаете JSON-данные, где строковые значения дважды экранированы, или когда нужно извлечь сырой текст из записи JSON-лога для отображения в UI или терминале. Конвейеры агрегации логов сталкиваются с этим постоянно: когда JSON-сообщение хранится как строковое значение внутри другого JSON-документа, каждый обратный слеш во внутренней строке приходит удвоенным.

Зачем использовать инструмент JSON Escape?

Добавлять или удалять обратные слеши вручную — утомительно и чревато ошибками, особенно при работе с многострочным текстом, путями к файлам или встроенными фрагментами кода. Специализированный инструмент экранирования улавливает крайние случаи, которые ручное редактирование пропускает.

Сценарии использования JSON String Escape

Справочник escape-последовательностей JSON

Спецификация JSON определяет ровно два обязательных экранирования (двойная кавычка и обратный слеш) и шесть коротких escape-последовательностей для распространённых управляющих символов. Все остальные управляющие символы (U+0000 — U+001F) должны использовать форму \uXXXX. Символы выше U+FFFF (например, emoji) можно представить как суррогатную пару UTF-16: \uD83D\uDE00.

Экранирование строк JSON vs. кодирование JSON

Разработчики иногда путают экранирование строки с кодированием полного JSON-документа.

Примеры кода

В каждом популярном языке есть встроенные функции для этого. Примеры на JavaScript, Python, Go и jq:

// JSON.stringify escapes a value and wraps it in quotes
JSON.stringify('Line 1\nLine 2')       // → '"Line 1\\nLine 2"'

// To get just the inner escaped string (no surrounding quotes):
const escaped = JSON.stringify('She said "hello"').slice(1, -1)
// → 'She said \\"hello\\"'

// Parsing reverses the escaping
JSON.parse('"tabs\\tand\\nnewlines"')  // → 'tabs\tand\nnewlines'

// Handling Unicode: emoji in JSON
JSON.stringify('Price: 5\u20ac')       // → '"Price: 5\u20ac"' (raw euro sign)

import json

# json.dumps escapes and quotes a string
json.dumps('Line 1\nLine 2')           # → '"Line 1\\nLine 2"'

# Ensure ASCII: replace non-ASCII with \uXXXX sequences
json.dumps('Caf\u00e9', ensure_ascii=True)   # → '"Caf\\u00e9"'

# Keep UTF-8 characters as-is (default in Python 3)
json.dumps('Caf\u00e9', ensure_ascii=False)  # → '"Caf\u00e9"'

# Unescape by round-tripping through json.loads
json.loads('"She said \\"hello\\""')      # → 'She said "hello"'

package main

import (
	"encoding/json"
	"fmt"
)

func main() {
	// json.Marshal escapes a Go string for JSON
	raw := "Line 1\nLine 2\tindented"
	b, _ := json.Marshal(raw)
	fmt.Println(string(b))
	// → "Line 1\nLine 2\tindented"

	// Unescape with json.Unmarshal
	var out string
	json.Unmarshal([]byte(`"She said \"hello\""`), &out)
	fmt.Println(out)
	// → She said "hello"
}

# Escape a raw string into a JSON-safe value
echo 'Line 1
Line 2	with tab' | jq -Rs '.'
# → "Line 1\nLine 2\twith tab\n"

# Unescape a JSON string back to raw text
echo '"She said \"hello\""' | jq -r '.'
# → She said "hello"

Часто задаваемые вопросы