Как настроить indentation и bracket pair guides в VS Code

Какая настройка отвечает за какую линию

• editor.guides.indentation. вертикальные линии по уровням отступов
• editor.guides.highlightActiveIndentation. выделение активного уровня отступа
• editor.guides.bracketPairs. направляющие между соответствующими скобками

Совет: Если на экране осталась вертикальная линия, сначала определите: она следует за отступом или за парой скобок.

Как настроить Guides

1. Откройте Settings и найдите Guides.
2. Переключите Editor › Guides: Indentation для линий отступа.
3. Отдельно настройте Editor › Guides: Bracket Pairs.
4. Откройте файл с несколькими вложенными блоками и скобками.
5. Поставьте курсор внутрь вложенного блока и проверьте, какая линия активна.

Предупреждение: Не используйте старые имена renderIndentGuides/highlightActiveIndentGuide из давних конфигураций: они были заменены новыми editor.guides.*.

Настройка через settings.json

Для простого варианта достаточно `"editor.guides.indentation": true` и нужного значения `editor.guides.bracketPairs`. Если вы переносите старый settings.json, удалите устаревшие ключи после проверки: иначе файл становится труднее обслуживать, хотя VS Code может показывать подсказку о deprecated-настройке. Меняйте по одному параметру и сразу смотрите результат на одном файле с понятной вложенностью.

Когда полезно разделять эти подсказки

В языках с явными скобками bracket pair guides помогают увидеть границы длинного блока, даже если внутри сложные переносы строк. В Python и YAML чаще полезнее обычные indentation guides, потому что структура напрямую связана с отступом. Это не жёсткое правило: обе функции визуальные, поэтому выбирайте комбинацию, которая ускоряет чтение кода, а не создаёт сетку из лишних линий.

Важно: Для командного репозитория эти параметры обычно не обязательны: это личное отображение, а не правило форматирования.

Если направляющие не видны

• проверьте, включён ли нужный тип guides;
• откройте файл с реальной вложенностью;
• проверьте Workspace и language-specific overrides;
• убедитесь, что цвет темы не делает линии почти незаметными.

Как не перегрузить редактор направляющими

Не обязательно включать все guides одновременно. Для кода с глубокими отступами обычно достаточно линии активного отступа; для языков с большим количеством вложенных скобок полезнее bracket pair guides. Включайте элементы по одному и смотрите, действительно ли они помогают находить границы блока. Если направляющие сливаются с темой, сначала проверьте другую тему или её цвета, а не добавляйте ещё больше линий. Настройки можно держать на уровне пользователя либо проекта: второй вариант имеет смысл, если команда демонстрирует код на одинаковых настройках, но обычно визуальные предпочтения лучше не навязывать репозиторию.

Что учитывать

Условия меняются. Страница отражает состояние на 2026-09-23; при расхождении с официальной документацией приоритет у первоисточника.

Источники и проверка

Фактическая часть сверена по первичным источникам (в т.ч. September 2021 (version 1.61) — bracket pair guides). Пример и формулировки — редакция N1RO на 2026-09-23.

• September 2021 (version 1.61) — bracket pair guides
• User interface — indent guides
• User and workspace settings