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

Разработка и Конфигурация · 10 мин

Как включить режим разработчика в 1С

Как включить режим разработчика в 1С: запуск Конфигуратора, включение отладки на клиенте и сервере, права доступа, типичные ошибки и ответы на вопросы.

Под «режимом разработчика» в 1С обычно понимают два разных инструмента: Конфигуратор (среда для изменения структуры базы и кода) и режим отладки (пошаговое выполнение кода с просмотром переменных). Первый запускается отдельным исполняемым файлом, второй включается настройками клиента или сервера. Ниже разобраны оба сценария для файлового и клиент-серверного вариантов работы.

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

Важное ограничение: работа в Конфигураторе с изменением структуры базы требует монопольного доступа — все пользователи должны выйти. Кроме того, типовые конфигурации часто находятся «на поддержке», и снятие с поддержки для правки кода осложнит последующие обновления. Об этом подробнее в разделе про риски.

Что понадобится перед включением

Для входа в Конфигуратор у пользователя должны быть права «Администрирование» и, как правило, «Толстый клиент» / «Обновление конфигурации базы данных» в зависимости от задач. Проще всего использовать учётную запись с полными правами. Если база без пользователей и паролей (типовая начальная настройка), Конфигуратор откроется без запроса.

Убедитесь, что у вас установлена платформа 1С той же версии, на которой работает база. Для клиент-серверного варианта понадобятся права администратора кластера (или помощь того, у кого они есть) — без них включить серверную отладку не получится.

Перед любыми изменениями конфигурации сделайте резервную копию: в файловом режиме достаточно скопировать файл 1Cv8.1CD при закрытой базе, в клиент-серверном — выгрузку через Конфигуратор (Администрирование → Выгрузить информационную базу) или штатный бэкап СУБД.

Как открыть Конфигуратор в файловом режиме

Самый простой путь — через стартовое окно 1С. Запустите ярлык 1С, выделите нужную информационную базу в списке и нажмите кнопку «Конфигуратор» в верхней панели окна запуска. Если кнопка не видна, проверьте, что выделена именно строка базы, а не пустая область списка.

Альтернатива — запуск из командной строки или ярлыка с явным указанием режима. Исполняемый файл платформы 1cv8.exe принимает параметр DESIGNER (в русскоязычной документации — режим «Конфигуратор»). Пример строки запуска для файловой базы:

bash
"C:\Program Files\1cv8\8.3.22.1750\bin\1cv8.exe" DESIGNER /F"D:\Bases\Trade"

После запуска откроется окно Конфигуратора. Если конфигурация не раскрыта, выполните «Конфигурация → Открыть конфигурацию». Дерево объектов (справочники, документы, отчёты, модули) появится слева — это и есть основная среда разработчика.

Признак успешного входа: в заголовке окна указан путь к базе, а меню «Конфигурация» содержит активные пункты «Конфигурация базы данных», «Обновить конфигурацию базы данных» и «Поддержка». Если пункты неактивны — конфигурация не открыта или нет прав.

Как включить режим отладки

Файловый вариант

Для файловой базы отладка включается параметром командной строки /debug. Добавьте его в ярлык запуска тонкого или толстого клиента после указания базы. Тонкий клиент запускается файлом 1cv8c.exe, толстый — 1cv8.exe с параметром ENTERPRISE.

После запуска клиента с отладкой откройте Конфигуратор той же базы и выполните «Отладка → Подключение». В списке появятся доступные предметы отладки — сеансы пользовательского приложения. Выберите свой сеанс, установите точку останова в нужном модуле (клик по левому полю строки кода) и выполните в клиенте действие, вызывающее этот код.

Клиент-серверный вариант

В клиент-серверном режиме отладку нужно разрешить на сервере. Откройте консоль администрирования серверов 1С, выберите кластер, откройте его свойства и установите флаг «Отладка разрешена». В некоторых версиях потребуется перезапуск службы агента сервера, чтобы параметр применился.

Дополнительно выберите протокол отладки: по умолчанию используется TCP, в новых релизах платформы рекомендуется HTTP-отладка через сервер отладки (dbgs). После включения отладки на кластере подключение предметов отладки выполняется так же — через меню «Отладка → Подключение» в Конфигураторе.

Порядок включения отладки (клиент-сервер)
  1. 1
    Откройте консоль администрирования серверов 1С и найдите нужный кластер
  2. 2
    В свойствах кластера установите флаг «Отладка разрешена» и выберите протокол
  3. 3
    Перезапустите службу агента сервера, если платформа это требует
  4. 4
    В Конфигураторе выполните «Отладка → Подключение» и выберите сеанс
  5. 5
    Установите точку останова и воспроизведите действие в клиенте

Как проверить, что режим включён

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

Для отладки контрольный признак — срабатывание точки останова: выполнение кода останавливается на выбранной строке, открывается стек вызовов и табло значений переменных. Если точка не срабатывает, проверьте, что подключён именно тот сеанс, что код реально выполняется на выбранной стороне (клиент или сервер) и что отладка разрешена на кластере.

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

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

Конфигуратор открыт
Норма

Дерево конфигурации видно, модули открываются

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

Ошибка прав доступа или пустое окно без дерева объектов

Отладка на клиенте
Норма

Сеанс виден в списке подключения, точка останова срабатывает

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

Список предметов отладки пуст при запущенном клиенте

Отладка на сервере
Норма

Серверные процедуры останавливаются на точке останова

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

Останавливается только клиентский код, серверные вызовы проходят мимо

Типичные ошибки и ограничения

Частая проблема — попытка обновить конфигурацию базы данных при работающих пользователях. Платформа потребует монопольный доступ и завершение всех сеансов. В файловом режиме завершите сеансы вручную, в клиент-серверном — через консоль кластера или с помощью блокировки сеансов в Конфигураторе («Администрирование → Блокировка установки соединений»).

Вторая типичная ошибка — правка типовой конфигурации без перевода её в режим изменений. Через «Конфигурация → Поддержка → Настройка поддержки» включите возможность изменений, но помните: объект, снятый с полной поддержки, перестанет обновляться автоматически при установке релизов. Для разовых доработок безопаснее использовать расширения конфигурации — они не затрагивают типовой код и не мешают обновлениям.

Типичные ошибки
01
Запуск отладки без параметра /debug — сеанс не появляется в списке подключения, точки останова не срабатывают
02
Снятие типовой конфигурации с поддержки ради мелкой правки — последующие обновления придётся накатывать вручную
03
Правка кода прямо в рабочей базе без копии — ошибка сразу затрагивает всех пользователей
04
Отладка серверного кода при выключенной отладке на кластере — серверные процедуры выполняются без остановки
05
Использование платформы другой версии, чем сервер — база может не открыться или потребовать конвертации

Расширения и внешние инструменты как альтернатива

Если задача — добавить печатную форму, кнопку или небольшую обработку, полноценный режим разработчика с изменением конфигурации не обязателен. Расширения конфигурации (Конфигурация → Расширения конфигурации) позволяют переопределять формы и обработчики, сохраняя типовую поддержку. Для разовых операций подойдут внешние обработки (.epf) и отчёты (.erf), которые открываются прямо в режиме «1С:Предприятие» через «Файл → Открыть».

Для разработки вне Конфигуратора существует EDT (1C:Enterprise Development Tools) — среда на базе Eclipse с контролем версий. Она подходит командной разработке, но требует отдельной установки и работает с проектами, а не напрямую с базой. Для разовой задачи «посмотреть и поправить код» Конфигуратор остаётся самым быстрым вариантом.

Сравнение вариантов

Конфигуратор

Полный доступ к коду и структуре; подходит для любых доработок, но изменения типовых объектов осложняют обновление

Расширение конфигурации

Доработки без снятия с поддержки; ограничение — не все объекты и сценарии можно переопределить

Внешние обработки и отчёты

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

1C:EDT

Командная разработка, git, проверки качества кода; избыточна для мелких правок и требует освоения

Часто задаваемые вопросы

Можно ли включить режим разработчика без прав администратора в 1С?

Открыть Конфигуратор можно только с правами на администрирование и обновление конфигурации. Без них доступна лишь работа в режиме «1С:Предприятие». Если прав нет, попросите администратора базы выдать их временно или выполнить нужные действия. Просмотр кода без изменений всё равно требует входа в Конфигуратор.

Почему в списке подключения отладки пусто?

Чаще всего клиент запущен без параметра /debug, либо отладка не разрешена на кластере сервера. Также проверьте, что Конфигуратор и клиент работают с одной и той же базой и что версии платформы совпадают. При HTTP-отладке убедитесь, что запущен сервер отладки dbgs.

Чем отличается тонкий клиент от толстого при отладке?

Тонкий клиент (1cv8c.exe) не содержит встроенного Конфигуратора и выполняет больше кода на сервере, поэтому часть логики отлаживается только на стороне сервера. Толстый клиент исполняет больше кода локально. Для файловой базы отладка в толстом клиенте обычно проще и нагляднее.

Опасно ли включать отладку на рабочем сервере?

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

Как открыть Конфигуратор, если база запаролена и пароль утерян?

Штатного способа восстановить пароль нет. Если есть другой пользователь с полными правами, он может сбросить пароль через «Администрирование → Пользователи». Иначе потребуется восстановление из резервной копии или обращение к специалистам по сопровождению 1С.

Итог

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

Режим разработчика в 1С — это Конфигуратор плюс отладка: первый открывается через стартовое окно или параметр DESIGNER, вторая включается параметром /debug для файловых баз и флагом «Отладка разрешена» на кластере для клиент-серверных. Перед изменениями делайте копию базы, а для доработок типовых конфигураций предпочитайте расширения.