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