Как автоматически выравнивать и форматировать код в 1С по колонкам и знакам равенства

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

В этой статье мы подробно разберем, как уйти от ручной рутины и настроить автоматическое вертикальное форматирование кода в экосистеме 1С с помощью современных плагинов и сред разработки.

Проблема ручного выравнивания: почему пробелы и табы не работают

Рассмотрим стандартную ситуацию. Разработчик хочет объявить несколько переменных и присвоить им значения. Если выравнивать их вручную, то код будет выглядеть аккуратно:

ИмяПользователя             = "Иван";
ДлинноеИмяПеременнойСДанными = 150;
Статус                       = Истина;

Но что произойдет, если нам понадобится переименовать переменную Статус в ТекущийСтатусДокумента? Нам придется вручную дописывать пробелы во всех остальных строках, чтобы сохранить красивую вертикальную линию знаков равенства. Это отнимает драгоценное время программиста. К счастью, этот процесс можно и нужно автоматизировать.

Способ 1. Автоматизация в стандартном Конфигураторе 1С

Если вы продолжаете работать в классическом Конфигураторе 1С, вам на помощь придут специализированные утилиты и плагины, которые добавляют недостающий функционал форматирования.

1. Использование TurboConf

Это один из самых популярных инструментов для автоматизации работы в Конфигураторе. В нем заложена специальная функция быстрого выравнивания выделенного блока текста. Разберем основные комбинации клавиш:

1. Выделите строки кода, которые необходимо выровнять.
2. Нажмите комбинацию клавиш Ctrl + = — программа автоматически выстроит все знаки равенства строго друг под другом.
3. Нажмите комбинацию Ctrl + < — плагин выровняет списки параметров по запятым.

Также в маркетплейсе плагинов TurboConf доступны дополнительные скрипты для интеграции с внешними форматтерами, что позволяет гибко настроить правила оформления под стандарты вашей компании.

2. Использование Smart Configurator

Отличная бесплатная альтернатива, работающая на базе OneScript. Этот плагин добавляет в Конфигуратор удобные команды:

• Выравнивание по знаку равенства;
• Выравнивание по первой запятой;
• Очистка модуля от избыточных пробелов и пустых строк.

3. Утилита ones-formatting

Это готовое open-source решение для быстрого форматирования кода 1С. По нажатию горячих клавиш Ctrl + Alt + F утилита автоматически анализирует выделенный фрагмент текста, окружает операторы пробелами, переносит длинные строки и выполняет красивое вертикальное выравнивание.

Способ 2. Настройка автоматического форматирования в VS Code

Современная разработка на платформе 1С все чаще переносится во внешние редакторы, такие как Visual Studio Code. Здесь за выравнивание кода отвечает мощный статический анализатор BSL Language Server.

Чтобы настроить автоматическое выравнивание «при сохранении файла», выполните следующие шаги:

Шаг 1. Установите расширение Language 1C (BSL) в VS Code.

Шаг 2. В корне вашего проекта (или в настройках плагина) создайте файл конфигурации .bsl-language-server.json.

Шаг 3. Задайте параметры форматирования. Ниже приведен пример файла конфигурации, который активирует все функции вертикального выравнивания:

{
    "language": {
        "diagnostics": {
            "parameters": {
                "ВыравниватьПоРавно": true,
                "ВыравниватьПоЗапятой": true,
                "ВыравниватьПоКомментариям": true,
                "ВыравниватьПоСкобке": true
            }
        }
    }
}

Проанализируем, за что отвечает каждый параметр:

• ВыравниватьПоРавно — находит идущие подряд присваивания и выстраивает знаки = по самой длинной переменной.
• ВыравниватьПоЗапятой — выравнивает длинные списки передаваемых параметров в вызовах процедур и функций.
• ВыравниватьПоКомментариям — если в конце строк кода написаны комментарии, они будут аккуратно сдвинуты на одну вертикальную линию.
• ВыравниватьПоСкобке — выравнивает сложные вложенные конструкции.

После этого вам достаточно нажать стандартное сочетание клавиш форматирования VS Code (обычно Shift + Alt + F), и редактор мгновенно приведет код в идеальный вид.

Способ 3. Форматирование в среде разработки 1С:EDT

В официальной среде разработки 1С:EDT (Enterprise Development Tools), созданной на базе Eclipse, функционал форматирования встроен по умолчанию и имеет глубокие настройки.

Чтобы настроить правила выравнивания в EDT, выполните следующие действия:

1. Перейдите в меню Окно (Window) -> Параметры (Preferences).
2. Найдите раздел V8 -> Форматирование (Formatting).
3. В открывшемся окне настроек вы можете включить режим «Выравнивание». Этот режим позволяет автоматически переносить каждый операнд или параметр метода на новую строку и выравнивать их по позиции первого элемента.

Применение форматирования в EDT запускается простым сочетанием клавиш Ctrl + Shift + F.

Подведем итоги

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

• Если вы работаете в классическом Конфигураторе — используйте TurboConf или ones-formatting.
• Если вы перешли на современные стандарты разработки — настройте файл конфигурации для BSL Language Server в VS Code или активируйте правила автоформатирования в 1С:EDT.