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

Другое · 6 мин

Как закомментировать строку в 1С

Разберём, как закомментировать строку в коде 1С: какой символ использовать, порядок действий, проверка результата и частые ошибки при отладке.

В конфигураторе 1С:Предприятия комментарий — это часть текста модуля, которую платформа игнорирует при проверке синтаксиса и выполнении программы. Основной способ выделить строку как комментарий — поставить в начале строки или после кода на той же строке два символа слэша: //. Всё, что находится после этих символов до конца строки, не влияет на логику и не выполняется.

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

Как выглядит комментированная строка в 1С

Пример записи в модуле: // Сообщение пользователю. Если код уже есть, добавить комментарий можно в конце той же строки: Сообщить("Привет"); // тестовая строка. В обоих случаях платформа не выполняет текст после //.

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

Где в 1С можно использовать комментарии строк

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

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

Внутри процедуры закомментированная строка пропускается при выполнении, поэтому временно отключённый код не повлияет на расчёты, записи в регистры или формирование документов. Это удобно при поиске причины ошибки.

Комментарии в запросах и выражениях

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

Порядок действий
  1. 1
    Откройте модуль в конфигураторе 1С
  2. 2
    Поставьте // в начале строки или после кода
  3. 3
    Сохраните изменения и проверьте синтаксис
  4. 4
    Убедитесь, что закомментированный код не выполняется

Как закомментировать строку в редакторе кода

Откройте нужный модуль в конфигураторе, установите курсор в начало строки или в место, с которого должен начаться комментарий, и введите //. Если нужно закомментировать несколько строк, повторите действие для каждой строки или выделите фрагмент и примените команду редактора, если она доступна в вашей версии.

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

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

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

Строка модуля с //
Норма

Проверка синтаксиса проходит, фрагмент не влияет на выполнение

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

Код выполняется или синтаксис выдаёт ошибка

Как проверить, что строка закомментирована правильно

Признак корректного комментария: текст после // не подсвечивается как исполняемая команда, проверка синтаксиса не ругается на эту строку, а при запуске алгоритма отключённый фрагмент пропускается. Если код всё ещё выполняется, скорее всего символы // поставлены не в том месте или строка не относится к встроенному языку.

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

Ограничения и риски при отключении кода

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

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

Типичные ошибки
01
Поставил // только перед первой строкой многострочного выражения
02
Закомментировал объявление переменной, которая используется ниже

Частые ошибки при комментировании в 1С

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

Также не стоит закомментировать объявление переменной, если эта переменная используется ниже, и не удалять комментарии, объясняющие сложную бизнес-логику, без замены документацией.

Альтернативы и когда комментарий не подходит

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

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

Итог

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

В 1С строку закомментируют символами //, всё после них игнорируется до конца строки, а изменения нужно проверять на копии перед работой в основной базе.

Можно ли закомментировать несколько строк сразу?

В редакторе конфигуратора зависит от версии платформы: иногда есть команда выделения и комментирования блока, в других случаях приходится ставить // в начале каждой строки отдельно.

Работает ли // в текстах запросов 1С?

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

Что делать, если закомментированный код всё ещё выполняется?

Проверьте, что // стоит перед исполняемой инструкцией, а не перед комментарием или пустой строкой, и что код не находится в другом модуле или подключённой обработке.

Безопасно ли отключать код в рабочей базе?

Не безопасно без тестирования: отключение проведения, записей или расчётов может нарушить данные; сначала проверяйте на копии или резервной базе.