Как изменить файл JSON: способы редактирования и проверки

Один пропущенный символ в файле .json — лишняя запятая или незакрытая кавычка — делает весь документ нечитаемым для программы, которая его загружает. Поэтому перед тем как изменить файл JSON, нужно понимать его структуру: пары «ключ — значение» внутри фигурных скобок, где любой текст обязательно заключается в двойные кавычки.

JSON (JavaScript Object Notation) — это обычный текстовый формат для хранения настроек, конфигураций и данных. Его можно открыть и отредактировать в любом текстовом редакторе, но удобство и безопасность правок сильно зависят от выбранного инструмента и соблюдения правил синтаксиса.

Что нужно знать перед редактированием

Файл JSON не содержит форматирования, как документы Word, — это чистый текст. Однако у него строгая грамматика. Нарушение хотя бы одного правила приводит к ошибке парсинга, и приложение откажется читать файл целиком.

• 🔑 Все ключи и строковые значения пишутся только в двойных кавычках — одинарные не допускаются.
• 📐 Элементы разделяются запятыми, но после последнего элемента запятой быть не должно — это самая частая ошибка.
• 🧩 Вложенные данные оформляются через фигурные скобки {} (объект) и квадратные [] (массив).
• 🔢 Числа и логические значения true/false пишутся без кавычек.

Перед любыми правками сделайте резервную копию файла. Достаточно скопировать его в соседнюю папку или переименовать в config_backup.json. Если после изменений программа перестанет запускаться, оригинал можно будет вернуть за секунды.

Как изменить JSON в Блокноте Windows

Самый простой способ — встроенный Блокнот Windows. Щёлкните по файлу правой кнопкой мыши, выберите Открыть с помощью и укажите Блокнот. Если его нет в списке, нажмите «Выбрать другое приложение».

Внесите правки, соблюдая синтаксис, и сохраните файл через Файл → Сохранить. При выборе «Сохранить как» убедитесь, что в поле «Тип файла» стоит «Все файлы», иначе Блокнот добавит расширение .txt, и файл перестанет распознаваться как JSON.

⚠️ Внимание: Блокнот не подсвечивает ошибки синтаксиса. Опечатку вы заметите только тогда, когда программа откажется читать файл. Для правок длиннее пары строк лучше использовать редактор с проверкой JSON.

Редактирование в VS Code и Notepad++

Бесплатные редакторы Visual Studio Code и Notepad++ заметно упрощают работу. Они подсвечивают синтаксис, автоматически закрывают скобки и подчёркивают ошибки ещё до сохранения файла.

Shift + Alt + F

⚠️ Внимание: не вставляйте в онлайн-сервисы файлы с паролями, токенами, ключами API или персональными данными. Содержимое может обрабатываться на стороннем сервере. Для конфиденциальных конфигураций используйте только локальные редакторы.

import json

with open('config.json', 'r', encoding='utf-8') as f:
data = json.load(f)

data['имя_параметра'] = 'новое_значение'

with open('config.json', 'w', encoding='utf-8') as f:
json.dump(data, f, ensure_ascii=False, indent=4)