К статье
Практический материал

Разработка и Конфигурация · 9 мин

Ширина табуляции в 1С: что это и как настроить

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

Ширина табуляции в 1С — это параметр текстового редактора конфигуратора, который определяет, сколько позиций (условных символов) занимает один отступ при нажатии клавиши Tab или при автоматическом форматировании кода. От этой настройки зависит, как будет выглядеть модуль на экране: насколько глубоко смещаются вложенные блоки «Если…Тогда», тела циклов, процедуры и функции.

Настройка влияет только на отображение и вставку отступов, но не на работу кода: платформа 1С игнорирует пробелы и табуляции при выполнении. Однако для читаемости, командной разработки и соответствия стандартам разработки единый размер отступа имеет практическое значение. Разные значения у разных разработчиков приводят к «пляшущему» коду при совместном просмотре модулей.

Ниже разберём, где именно задаётся ширина табуляции, какие значения принято использовать, чем табуляция отличается от пробелов и как проверить результат после изменения настроек.

Где в конфигураторе задаётся ширина табуляции

Основная настройка находится в параметрах текстового редактора конфигуратора. Откройте конфигуратор, перейдите в меню «Сервис → Параметры» и выберите вкладку «Тексты» (в отдельных версиях платформы есть подразделы «Тексты» и «Модули» с похожими наборами опций). Там находится поле «Ширина табуляции» — число, задающее размер отступа в позициях.

Рядом обычно расположены связанные параметры: автоматический отступ при переходе на новую строку, выравнивание по синтаксическим конструкциям, замена табуляции пробелами. Эти опции работают в связке: если ширина табуляции равна 4, а автоотступ включён, то после строки «Если Условие Тогда» курсор на новой строке автоматически сместится на 4 позиции вправо.

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

Как изменить ширину табуляции
  1. 1
    Откройте конфигуратор 1С и любой модуль, чтобы видеть результат.
  2. 2
    Перейдите в меню «Сервис → Параметры».
  3. 3
    Откройте вкладку «Тексты» (или «Модули»).
  4. 4
    Найдите поле «Ширина табуляции» и установите значение 4.
  5. 5
    Проверьте связанные опции: автоотступ и замену табуляции пробелами.
  6. 6
    Нажмите «ОК», выделите фрагмент кода и выполните форматирование (Ctrl+Shift+F или пункт «Текст → Форматировать»), чтобы увидеть новые отступы.

Какое значение выбрать и почему

Наиболее распространённое значение — 4 символа. Именно такой отступ фигурирует в стандартах разработки на встроенном языке 1С и используется в типовых конфигурациях. При ширине 4 вложенные блоки хорошо различимы визуально, но строки не уходят слишком далеко вправо даже при трёх-четырёх уровнях вложенности.

Значение 2 экономит горизонтальное пространство, но снижает визуальное различие уровней вложенности — особенно на мониторах с мелким шрифтом. Значение 8 делает отступы слишком глубокими: длинные условия и вызовы процедур начинают выходить за границу экрана, что вынуждает постоянно прокручивать код по горизонтали.

Главное правило для команды — единообразие. Если в проекте принят отступ 4, все участники должны выставить одинаковое значение, иначе при открытии чужих модулей код будет «разъезжаться», а сравнение версий в хранилище покажет ложные изменения строк.

Сравнение значений ширины табуляции

2 символа

Компактно, но уровни вложенности плохо различимы; подходит только для личных экспериментов, не для командной работы.

4 символа

Стандарт де-факто для 1С: хороший баланс читаемости и ширины строк; рекомендуется в большинстве проектов.

8 символов

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

Табуляция или пробелы: в чём разница

Отступ в тексте модуля может быть сформирован двумя способами: символом табуляции (один специальный символ, который редактор отображает шириной в N позиций) или последовательностью обычных пробелов. Платформа 1С допускает оба варианта, и на выполнение кода это не влияет.

Разница проявляется при совместной работе. Если один разработчик использует табуляцию с шириной 4, а другой — с шириной 2, то один и тот же файл у них отобразится по-разному. Пробелы в этом смысле стабильнее: четыре пробела выглядят одинаково у всех. Однако табуляция удобнее при редактировании — один отступ добавляется и удаляется одним нажатием клавиши.

В параметрах редактора есть опция вставки пробелов вместо символов табуляции. Если в команде договорились о пробелах, включите её у всех участников. Если договорились о табуляции — убедитесь, что ширина у всех одинаковая.

Как ширина табуляции влияет на форматирование и проверку кода

Встроенное форматирование модуля (пункт контекстного меню «Форматировать» или сочетание клавиш) перестраивает отступы выделенного фрагмента в соответствии с текущими настройками редактора. Если вы изменили ширину табуляции, уже написанный код сам не изменится — отступы обновятся только после явного форматирования.

Это удобный способ привести чужой или унаследованный модуль к принятому стандарту: выделите весь текст (Ctrl+A) и выполните форматирование. При этом стоит помнить, что массовое переформатирование создаёт большое количество изменений при сравнении с предыдущей версией в хранилище конфигураций — реальные правки логики «утонут» среди изменений отступов.

Поэтому переформатирование целых модулей лучше выполнять отдельным коммитом (отдельной фиксацией в хранилище) с понятным комментарием, не смешивая его с функциональными изменениями.

Типичные ошибки и ограничения

Первая ошибка — смешивание табуляции и пробелов в одном модуле. Визуально у автора всё ровно, но у коллеги с другой шириной табуляции блоки «плывут». Лечится выбором одного способа отступов и форматированием существующего кода.

Вторая ошибка — ожидание, что изменение настройки перепишет существующий код. Параметр влияет только на новые отступы и явное форматирование; старый текст остаётся как есть, пока вы его не обработаете.

Третья ошибка — перенос привычек из других сред разработки без проверки. В некоторых редакторах приняты отступы 2 или 8, но для модулей 1С стандартом является 4, и отклонение усложняет чтение кода коллегами и аудиторами.

Типичные ошибки
01
Смешение табуляции и пробелов в одном модуле — отступы отображаются по-разному у разных разработчиков.
02
Разная ширина табуляции у членов команды — «пляшущий» код и ложные различия при сравнении версий.
03
Ожидание автоматического обновления старого кода после смены настройки — отступы меняются только при форматировании.
04
Массовое переформатирование вместе с правками логики — невозможно быстро найти реальные изменения в хранилище.

Как проверить результат после настройки

Откройте любой модуль, поставьте курсор внутрь условия или цикла и нажмите Enter: новая строка должна сместиться на заданное число позиций. Затем выделите фрагмент с вложенными блоками и выполните форматирование — уровни вложенности должны выровняться равномерно.

Дополнительная проверка — открыть тот же модуль на рабочем месте коллеги или попросить прислать скриншот. Если отступы совпадают, настройки согласованы. Если нет — сверьте ширину табуляции и режим «пробелы вместо табуляции» на обоих компьютерах.

Контрольные точки

Как проверить результат

Автоотступ при новой строке
Норма

Курсор смещается ровно на заданное число позиций внутри блока

Тревожный признак

Отступ больше или меньше ожидаемого — проверьте значение в параметрах

Форматирование вложенных блоков
Норма

Все уровни вложенности выровнены равномерно

Тревожный признак

Часть строк смещена иначе — в тексте смешаны табуляция и пробелы

Отображение у коллеги
Норма

Модуль выглядит одинаково на обоих рабочих местах

Тревожный признак

Отступы «плывут» — настройки рабочих мест различаются

Частые вопросы

Влияет ли ширина табуляции на скорость работы программы?

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

Почему после изменения настройки старый код не изменился?

Параметр применяется только к новым отступам и явному форматированию. Чтобы обновить существующий текст, выделите его и выполните команду форматирования модуля.

Что лучше для 1С: табуляция или пробелы?

Оба варианта работоспособны. Пробелы гарантируют одинаковое отображение у всех, табуляция удобнее при редактировании. Важно выбрать один способ на всю команду и не смешивать их в одном модуле.

Передаётся ли настройка табуляции вместе с конфигурацией?

Нет, это локальный параметр рабочего места разработчика. Единые правила отступов нужно фиксировать в регламенте разработки и контролировать при приёмке кода.

Как быстро привести весь модуль к единым отступам?

Откройте модуль, выделите весь текст (Ctrl+A) и выполните форматирование. Если модуль находится в хранилище, зафиксируйте это изменение отдельно от функциональных правок.

Итог

Что важно запомнить

Ширина табуляции — локальная настройка редактора модулей, задающая размер отступа; рекомендуемое значение — 4 символа. Настройка не меняет старый код автоматически и не передаётся с конфигурацией, поэтому единые правила отступов команда должна закрепить договорённостью и применять форматирование отдельно от правок логики.