Другое · 7 мин
Многострочный комментарий в 1С: порядок действий и нюансы
Как сделать многострочный комментарий в 1С: комментирование строк через //, блоковое выделение в конфигураторе, проверка синтаксиса и ограничения языка.
В встроенном языке 1С:Предприятия комментарий начинается с символов // и действует до конца строки. Стандартного разделителя для блока вида / ... / в модулях конфигурации обычно нет, поэтому «многострочный» комментарий реализуется как набор последовательных однострочных комментариев.
Чтобы закомментировать фрагмент кода, достаточно поставить // перед каждой строкой, которую не нужно выполнять. В редакторе конфигуратора есть также блоковое комментирование выделенного фрагмента: редактор автоматически добавляет // к каждой выделенной строке, а повторное действие убирает эти символы.
Комментарии не влияют на выполнение алгоритма, но помогают временно отключить участок кода, оставить пояснение для себя или коллег, а также документировать причину изменения логики. Основное правило — после любых массовых изменений обязательно проверьте синтаксис и поведение на копии информационной базы.
Сравнение вариантов
Поддерживаются встроенным языком, подходят для временного и постоянного использования
Удобно для выделения нескольких строк, зависит от возможностей конкретного редактора конфигуратора
Подходит для неиспользуемой логики, требует резервной копии и проверки после удаления
Что считать комментарием в коде 1С
Комментарий в модуле объекта, общего модуля, формы или обработки — это текст, который игнорируется при компиляции и выполнении. Он начинается с // и заканчивается переводом строки. Всё, что стоит после // на той же строке, не участвует в работе программы.
Важно не путать комментарии к коду с текстовыми полями документа, справочника или отчета. Комментарий в программном модуле не сохраняется в базе как комментарий к записи, он существует только в тексте конфигурации и предназначен для разработчиков и администраторов.
- 1Откройте модуль в конфигураторе
- 2Выделите строки для комментирования
- 3Примените блочное комментирование
- 4Проверьте синтаксис модуля
- 5При необходимости раскомментируйте код
Как закомментировать несколько строк в редакторе конфигуратора
Откройте нужный модуль в режиме конфигуратора, выделите мышью фрагмент кода, который нужно выключить, и примените команду комментирования выделения. В большинстве случаев это сочетание клавиш Ctrl+/, а также соответствующий пункт меню редактирования. Каждая выделенная строка получит префикс //.
Чтобы вернуть код к работе, снова выделите те же строки и примените раскомментирование. Редактор уберет // с начала строк, если они были добавлены именно блочной операцией. После этого выполните проверку синтаксиса модуля.
Почему нельзя использовать / ... / и чем это опасно
Попытка вставить / в начале блока и / в конце обычно приводит к ошибке компиляции, потому встроенный язык не распознает такой парный разделитель в модульном коде. Редактор подсветит фрагмент как ошибочный, а конфигурация не будет сохранена до исправления.
Если разработчик привык к блочным комментариям из других языков, он может оставить /* в коде и случайно закомментировать гораздо больше строк, чем планировал, или наоборот оставить исполняемый фрагмент без защиты. Поэтому перед массовыми изменениями рекомендуется сделать резервную копию конфигурации или информационной базы.
Как проверить результат
Синтаксическая проверка проходит
Редактор подсвечивает /* или // как ошибку
Отключенный фрагмент не влияет на результат
Выполняются действия из закомментированного блока
Как проверить, что комментарий работает корректно
После комментирования выделенные строки должны визуально отличаться от исполняемого кода, а при попытке сохранить модуль ошибок синтаксиса не должно быть. Если модуль содержит процедуру или функцию, запустите связанную с ней операцию и убедитесь, что закомментированные действия не выполняются.
Признак успешного результата — конфигурация сохраняется без предупреждений, а логика программы ведет себя так, как если бы закомментированного фрагмента не существовало. Если после раскомментирования появляются ошибки, проверьте, не остались ли лишние // внутри строковых литералов или конструкций.
Ограничения и границы безопасной работы
Не комментируйте вызовы записи, проведения, перерасчета или обмена данными, если не уверены, что отключение не нарушит целостность информации. Даже временное отключение такой логики может привести к несоответствиям в регистрах, остатках или документах.
Работать с кодом конфигурации безопасно только на копии информационной базы или в изолированной среде разработки. Прямые изменения в рабочей базе без резервной копии и тестирования недопустимы, особенно если затрагиваются бухгалтерские или складские процедуры.
Альтернативы и когда комментировать не стоит
Если фрагмент кода больше не нужен, лучше удалить его полностью, чем оставить закомментированным на постоянной основе. Мертвый код усложняет поддержку, затрудняет чтение модуля и может ввести в заблуждение других разработчиков.
Для длительных пояснений удобнее использовать отдельную документацию к конфигурации или описание свойств объекта, а не огромные блоки комментариев внутри кода. Это упрощает поддержку и снижает вероятность случайного изменения исполняемого текста при правке комментариев.
Сравнение способов отключения фрагмента кода
Что важно запомнить
В 1С многострочный комментарий строится из однострочных //, блочного разделителя /<em> ... </em>/ в модулях обычно нет, а массовые изменения требуют проверки и резервной копии.
Нужно ли ставить // на каждую строку вручную?
Не обязательно. Редактор конфигуратора может добавить // ко всем выделенным строкам одной командой, а затем убрать их повторным действием. Вручную расставлять символы нужно только при точечном редактировании отдельных строк.
Работают ли комментарии / ... / в запросах 1С?
В тексте модулей встроенного языка такой разделитель обычно не поддерживается. Для языков запросов и других встроенных средств синтаксис комментариев может отличаться, поэтому проверяйте конкретный редактор и справку по используемой конструкции.
Можно ли закомментировать целый модуль?
Технически можно поставить // перед каждой строкой модуля, но это не удаляет код из конфигурации и не делает модуль невидимым для системы. Лучше отключить использование модуля через свойства конфигурации или удалить неиспользуемый код после проверки.
Что делать, если после раскомментирования появились ошибки?
Проверьте, не остались ли лишние // в начале строк, не попали ли символы комментария внутрь строковых литералов или конструкций кода. Выполните синтаксическую проверку модуля и сравните результат с рабочей копией до изменений.
Безопасно ли комментировать код в рабочей информационной базе?
Не рекомендуется без резервной копии и тестирования на отдельной копии базы. Отключение вызовов записи, проведения или обмена может повлиять на данные, поэтому изменения в конфигурации лучше вводить через среду разработки с последующим обновлением рабочей базы.