Форматирование кода в платформе 1C:Предприятие выполняется по официальным стандартам и правилам, разработанные фирмой «1С». Их главная цель — сделать код легко читаемым для любого разработчика.
Правила именования в 1С:Предприятие
Для всех имен переменных, процедур, функций и объектов используется CamelCase (верблюжий регистр) без подчеркиваний.
Правильно: КонтрагентСсылка, РассчитатьСуммуДокумента().
Неправильно: контрагент_ссылка, рассчитатьсумму().
Имена должны быть понятными и легко читаться вслух. Избегайте двусмысленных сокращений.
Правильно: СотрудникИмя, УдалитьЭлемент().
Неправильно: СотрИм, УдЭл().
Оформление текстов запросов 1С
Запросы — самая критичная часть кода для чтения. Они всегда выравниваются по левому краю ключевых слов. Ключевые слова пишутся ЗАГЛАВНЫМИ буквами. Имена таблиц и полей — в CamelCase.Каждый новый раздел (ВЫБРАТЬ, ИЗ, ГДЕ) начинается с новой строки.
Например правильного форматирования запроса
Запрос = Новый Запрос;
Запрос.Текст =
"ВЫБРАТЬ
| Номенклатура.Ссылка КАК Товар,
| Номенклатура.Код КАК Код
|ИЗ
| Справочник.Номенклатура КАК Номенклатура
|ГДЕ
| НЕ Номенклатура.ЭтоГруппа";Отступы, пробелы и переносы в коде 1С:Предприятие
Для смещения текста внутри условий, циклов и процедур используется исключительно знак табуляции (Tab). Обычные пробелы для отступов запрещены. Пробелы в выражениях: Операторы присваивания (=), сравнения (>, <), математические знаки (+, -) и логические условия (И, ИЛИ) всегда отделяются пробелами с двух сторон.
Правильно: Сумма = Цена * Количество;
Неправильно: Сумма=Цена*Количество;
После имени функции пробел перед скобкой не ставится. Между параметрами внутри скобок пробел после запятой обязателен.
Правильно: ВыполнитьРасчет(Параметр1, Параметр2);
Оформление условий и циклов 1С:Предприятие
Ключевые слова Тогда, Цикл, Делать переносятся на новую строку, если само условие или заголовок цикла длинные. Если условие короткое, их можно оставить на одной строке. Например оформления условий.
Если Номенклатура.Услуга Тогда
Возврат;
КонецЕсли;
Если (СуммаДокумента > 100000
И Контрагент.Надежный) ИЛИ Статус = Перечисления.Статусы.VIP Тогда
ПредоставитьСкидку();
КонецЕсли;Форматирование кода 1C:Предприятие использование встроенных инструментов
В конфигураторе 1С есть встроенный автоматический механизм форматирования кода. Чтобы не выравнивать код вручную:
- Выделите нужный участок кода (или Ctrl + A, чтобы выделить всё).
- Нажмите комбинацию клавиш Alt + Shift + F (команда Текст — Блок — Форматировать). Платформа сама расставит правильные отступы согласно синтаксису.