При активной разработке в многопользовательском режиме или при обновлении сильно доработанных конфигураций программисты часто сталкиваются с проблемой «визуального шума». Штатный механизм сравнения и объединения модулей в Конфигураторе 1С далеко не всегда корректно сопоставляет блоки кода, особенно если разные разработчики используют разные настройки форматирования: кто-то предпочитает табуляцию, кто-то — пробелы, а кто-то добавляет пустые строки или переставляет процедуры местами. В результате штатное сравнение показывает изменения по всему модулю, хотя логика функций осталась прежней.
Разберем подробно, как решить эту проблему, используя внешние инструменты и современные методики нормализации кода.
Первое, что нам необходимо сделать, — это переключить стандартный механизм сравнения текстов на более продвинутый внешний инструмент. Платформа 1С позволяет интегрировать сторонние утилиты непосредственно в процесс разработки. Проанализируем, как это настроить по шагам:
После этой настройки при попытке сравнить модули в окне сравнения/объединения (через контекстное меню «Сравнить файлы» или при сравнении конфигураций) система будет вызывать сторонний редактор, который гораздо эффективнее справляется с анализом текста.
Рассмотрим наиболее популярные инструменты, которые рекомендуют опытные разработчики. Выясним, почему стандартного функционала часто не хватает.
kdiff3 — это один из самых мощных бесплатных инструментов. Его главное преимущество заключается в алгоритме, который пытается сопоставить текст даже после серьезных перестановок блоков. Рассмотрим его особенности:
p4merge (Perforce Visual Merge Tool) — инструмент с очень приятным визуальным интерфейсом. Он отлично подсвечивает изменения, однако, как показывает практика обсуждений, иногда он уступает kdiff3 в интеллектуальном сопоставлении строк, если в коде было слишком много хаотичных правок форматирования. Тем не менее, для многих он остается «золотым стандартом» благодаря своей наглядности.
Если бюджет позволяет использовать платные решения, проанализируем возможности Beyond Compare. Это профессиональный инструмент, который считается эталоном в среде 1С-разработчиков. Рассмотрим, какие уникальные функции он предлагает:
Во-первых, это Alignment Overrides (переопределение выравнивания). Если автоматика запуталась, мы можем вручную указать программе, что Процедура ПриСозданииНаСервере в левом файле соответствует той же процедуре в правом, даже если она переместилась на 500 строк вниз. После этого программа пересчитает все остальные изменения относительно этой точки.
Во-вторых, тонкая настройка игнорирования «несущественных различий». Мы можем настроить фильтр так, чтобы программа вообще не считала изменениями разницу между // Комментарий и его отсутствием, или игнорировала регистр символов.
Чтобы штатное сравнение 1С работало лучше, проанализируем ситуацию с точки зрения чистоты кода. Если перед сравнением привести оба модуля к единому стандарту оформления, количество ложных срабатываний сократится на 90%. Рассмотрим инструменты для автоматического форматирования:
BSL Language Server — это современный инструмент, который позволяет автоматически форматировать код 1С. Мы можем прогнать модули через линтер со следующими правилами:
Посмотрим на пример того, как код выглядит «до» и «после» автоматической очистки:
// До очистки
Процедура РассчитатьСумму(Объект)
Сумма = Объект.Цена * Объект.Количество;
КонецПроцедуры
// После очистки (единый стандарт)
Процедура РассчитатьСумму(Объект)
Сумма = Объект.Цена * Объект.Количество;
КонецПроцедуры
Если выгрузить файлы конфигурации в текстовый формат (через Выгрузить конфигурацию в файлы...), применить к ним автоматическое форматирование и только потом сравнивать, результат будет практически идеальным.
Выясним, как фирма 1С решает проблему «глупого» сравнения в новых продуктах. В среде разработки EDT, построенной на базе Eclipse, механизмы сравнения и слияния реализованы на совершенно другом уровне. Рассмотрим преимущества EDT:
1. Структурное сравнение. EDT понимает, что модуль состоит из методов (процедур и функций). Если вы переместили функцию из начала модуля в конец, EDT не скажет «код удален сверху и добавлен снизу». Она покажет, что метод просто перемещен в рамках файла.
2. Интеграция с Git. Поскольку EDT работает с Git «из коробки», вы получаете доступ ко всем мощным алгоритмам слияния (merge), которые разрабатывались десятилетиями для всего мирового IT-сообщества.
3. Семантический анализ. Система видит изменения в сигнатурах методов (параметрах) отдельно от изменений в теле процедур.
Если же вы вынуждены работать исключительно в стандартном окне сравнения/объединения Конфигуратора (например, при обновлении типовой конфигурации через cf файл), воспользуйтесь следующими приемами:
1. Фильтр «Игнорировать несущественные различия». В окне сравнения конфигураций нажмите кнопку «Настройка» и установите флажок «Игнорировать пустое пространство». Это заставит систему не подсвечивать строки, где изменились только пробелы.
2. Режим «По процедурам и функциям». По умолчанию 1С сравнивает модуль как единое текстовое полотно. Если переключить режим просмотра (иконка в виде иерархии), система попытается сопоставить именно структуру методов. Это помогает избежать «каши», когда изменения в одной маленькой функции в начале файла сдвигают весь остальной текст и делают его нечитаемым.
Рассмотрим, как это выглядит в коде, когда мы анализируем изменения вручную. Допустим, у нас есть старая версия:
Функция ПолучитьНалог(Сумма)
Возврат Сумма * 0.13;
КонецФункции
И новая версия, где программист добавил форматирование и новые условия:
Функция ПолучитьНалог( Сумма )
// Рассчитываем НДФЛ
Результат = Сумма * 0.13;
Возврат Результат;
КонецФункции
Используя kdiff3 или Beyond Compare, мы увидим только добавление строки с комментарием и переменной Результат, в то время как штатный механизм может пометить всю функцию как полностью измененную из-за пробелов внутри скобок ( Сумма ).
Для качественного сравнения модулей в 1С мы рекомендуем отказаться от использования только штатного визуализатора текста в пользу внешних инструментов. Связка kdiff3 или Beyond Compare, подключенная через настройки Конфигуратора, сэкономит вам часы времени при анализе чужого кода. Если же ваша команда готова к инновациям, постепенный переход на EDT полностью снимет проблему некорректного сравнения структурных элементов модуля.