Другое · 6 мин
Как закомментировать строку в 1С
Разберём, как закомментировать строку в коде 1С: какой символ использовать, порядок действий, проверка результата и частые ошибки при отладке.
В конфигураторе 1С:Предприятия комментарий — это часть текста модуля, которую платформа игнорирует при проверке синтаксиса и выполнении программы. Основной способ выделить строку как комментарий — поставить в начале строки или после кода на той же строке два символа слэша: //. Всё, что находится после этих символов до конца строки, не влияет на логику и не выполняется.
Комментирование полезно, когда нужно временно отключить фрагмент кода без удаления, оставить пояснение для себя или коллег, либо отметить место для доработки. Закомментированная строка остаётся в модуле, но не участвует в работе алгоритма, что упрощает отладку и возвращение к предыдущему варианту.
Как выглядит комментированная строка в 1С
Пример записи в модуле: // Сообщение пользователю. Если код уже есть, добавить комментарий можно в конце той же строки: Сообщить("Привет"); // тестовая строка. В обоих случаях платформа не выполняет текст после //.
Визуально в редакторе конфигуратора закомментированный фрагмент часто выделяется другим цветом, но точное оформление зависит от версии платформы и настроек редактора. Цвет не является признаком того, что код отключён; решающее значение имеют символы //.
Где в 1С можно использовать комментарии строк
Комментарии подходят в общих модулях, модулях объектов, модулях форм, менеджерах и других объектах конфигурации, где написан код на встроенном языке 1С. Их можно ставить перед процедурами, функциями, переменными и отдельными инструкциями.
Комментарии в процедурах и функциях
Внутри процедуры закомментированная строка пропускается при выполнении, поэтому временно отключённый код не повлияет на расчёты, записи в регистры или формирование документов. Это удобно при поиске причины ошибки.
Комментарии в запросах и выражениях
В текстах запросов и в выражениях языка запросов правила могут отличаться от правил встроенного языка, поэтому перед использованием // в запросе стоит убедиться, что конкретная версия платформы поддерживает такой синтаксис в этом контексте.
- 1Откройте модуль в конфигураторе 1С
- 2Поставьте // в начале строки или после кода
- 3Сохраните изменения и проверьте синтаксис
- 4Убедитесь, что закомментированный код не выполняется
Как закомментировать строку в редакторе кода
Откройте нужный модуль в конфигураторе, установите курсор в начало строки или в место, с которого должен начаться комментарий, и введите //. Если нужно закомментировать несколько строк, повторите действие для каждой строки или выделите фрагмент и примените команду редактора, если она доступна в вашей версии.
После внесения изменений сохраните модуль и выполните проверку синтаксиса. Если проверка проходит без ошибок, а отключённый фрагмент не влияет на работу, комментирование выполнено корректно.
Как проверить результат
Проверка синтаксиса проходит, фрагмент не влияет на выполнение
Код выполняется или синтаксис выдаёт ошибка
Как проверить, что строка закомментирована правильно
Признак корректного комментария: текст после // не подсвечивается как исполняемая команда, проверка синтаксиса не ругается на эту строку, а при запуске алгоритма отключённый фрагмент пропускается. Если код всё ещё выполняется, скорее всего символы // поставлены не в том месте или строка не относится к встроенному языку.
Также полезно сравнить поведение программы до и после комментирования на копии базы, чтобы убедиться, что отключённый фрагмент действительно не участвует в ключевых операциях.
Ограничения и риски при отключении кода
Не закомментируйте строки, отвечающие за проведение документов, запись в регистры накопления или расчёт зарплаты, если не уверены, что отключение не нарушит целостность данных. Временное отключение в рабочей базе может привести к неполным записям и ошибкам в отчётах.
Перед правками в действующей базе рекомендуется сделать резервную копию и протестировать изменения в отдельной информационной базе или копии. Не оставляйте закомментированный код навсегда без пояснения, иначе через время станет непонятно, зачем он нужен.
Частые ошибки при комментировании в 1С
Одна из ошибок — ставить // только перед частью выражения, продолжающегося на следующей строке. В таком случае только первая строка становится комментарием, а продолжение остаётся исполняемым и может вызвать ошибку синтаксиса. Другая ошибка — путать комментарии встроенного языка с синтаксисом запросов или внешних языков.
Также не стоит закомментировать объявление переменной, если эта переменная используется ниже, и не удалять комментарии, объясняющие сложную бизнес-логику, без замены документацией.
Альтернативы и когда комментарий не подходит
Если фрагмент кода больше не нужен, лучше удалить его или перенести в версионное хранилище, чем оставлять закомментированным на постоянной основе. Для постоянного отключения функциональности подходят настройки прав доступа, флаги в справочниках или выключение обработок, если это предусмотрено конфигурацией.
Когда нужно объяснить сложный алгоритм, комментарий полезнее, чем пустой код, но избыточное комментирование очевидных строк затрудняет чтение модуля.
Что важно запомнить
В 1С строку закомментируют символами //, всё после них игнорируется до конца строки, а изменения нужно проверять на копии перед работой в основной базе.
Можно ли закомментировать несколько строк сразу?
В редакторе конфигуратора зависит от версии платформы: иногда есть команда выделения и комментирования блока, в других случаях приходится ставить // в начале каждой строки отдельно.
Работает ли // в текстах запросов 1С?
Не во всех контекстах и версиях; перед использованием в запросе проверьте синтаксис конкретной платформы, так как правила могут отличаться от обычных модулей.
Что делать, если закомментированный код всё ещё выполняется?
Проверьте, что // стоит перед исполняемой инструкцией, а не перед комментарием или пустой строкой, и что код не находится в другом модуле или подключённой обработке.
Безопасно ли отключать код в рабочей базе?
Не безопасно без тестирования: отключение проведения, записей или расчётов может нарушить данные; сначала проверяйте на копии или резервной базе.