Шаблоны текста в 1С: как включить и работать с ними

Шаблоны текста в 1С — это встроенный механизм конфигуратора, который подставляет готовые фрагменты кода при вводе короткого сокращения. Например, набрав «Если» и нажав пробел или Ctrl+Q, разработчик получает развёрнутую конструкцию «Если … Тогда … КонецЕсли;» без ручного набора. Механизм экономит время при написании модулей и снижает количество синтаксических ошибок.

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

Материал ориентирован на работу в конфигураторе платформы 1С:Предприятие 8.3. Пути меню и пункты настроек могут незначительно отличаться в зависимости от версии платформы, но общая логика сохраняется.

Что такое шаблоны текста и где они хранятся

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

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

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

Как включить шаблоны текста в конфигураторе

Основная настройка находится в параметрах конфигуратора. Откройте конфигуратор, перейдите в меню Сервис → Параметры. В открывшемся окне выберите закладку Тексты модулей, а внутри неё — вкладку Шаблоны текста (в некоторых версиях платформы раздел так и называется).

Установите флажок «Использовать шаблоны текста». Ниже находится список подключённых файлов шаблонов: через кнопки «Добавить» и «Удалить» укажите нужные файлы .st. Если список пуст, добавьте стандартный файл шаблонов из каталога платформы либо свой файл. После нажатия «ОК» настройка применяется сразу, перезапуск конфигуратора не требуется.

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

1. 1
   Откройте конфигуратор и перейдите в Сервис → Параметры
2. 2
   Выберите закладку «Тексты модулей», затем раздел «Шаблоны текста»
3. 3
   Установите флажок «Использовать шаблоны текста»
4. 4
   Добавьте в список файлы шаблонов (.st) — стандартный или собственный
5. 5
   Нажмите «ОК» и проверьте работу в любом модуле: введите «Если» и нажмите Ctrl+Q

Как вызвать шаблон при написании кода

Основной способ вызова — комбинация клавиш Ctrl+Q. Поставьте курсор в модуль, нажмите Ctrl+Q: откроется окно со списком доступных шаблонов. Начните вводить название — список отфильтруется, выберите нужный шаблон и нажмите Enter. Текст вставится в позицию курсора.

Второй способ — автоподстановка. Если она включена, достаточно набрать сокращение шаблона (например, «Для», «Пока», «Процедура») и нажать пробел или Enter: сокращение развернётся в полную конструкцию. Если в модуле уже есть текст, совпадающий с началом сокращения, платформа предложит варианты через выпадающий список.

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

Как создать собственный шаблон

Собственные шаблоны полезны для повторяющихся конструкций конкретного проекта: типовой обработки исключений, записи в журнал регистрации, обращения к общим модулям. Чтобы создать шаблон, откройте любой модуль, перейдите в меню Текст → Шаблоны текста (или вызовите список через Ctrl+Q) и нажмите кнопку настройки/редактирования шаблонов.

В редакторе шаблонов создайте новый элемент: укажите сокращение (слово-вызов), полное наименование и сам текст шаблона. В тексте используйте служебные конструкции: метку позиции курсора, вставку выделенного фрагмента, подстановку текущей даты или имени процедуры. Сохраните шаблон — он появится в списке и станет доступен по Ctrl+Q.

Если шаблоны должны использоваться всей командой, сохраните их в отдельный файл .st, разместите файл в общем доступе и подключите его в настройках каждого разработчика. При обновлении файла достаточно заменить его в общей папке — конфигуратор подхватит изменения после переподключения или перезапуска.

Давайте сокращениям короткие, но непересекающиеся имена. Если сокращение совпадает с началом обычного слова кода, автоподстановка будет срабатывать не вовремя и раздражать. Префикс вроде «_жр» или «хОбр» для корпоративных шаблонов решает проблему.

Почему шаблоны не работают: диагностика

Если Ctrl+Q не открывает список или подстановка не срабатывает, причина почти всегда в одном из нескольких типовых мест. Проверяйте их последовательно — от настроек к файлам.

Первая причина — снят флажок «Использовать шаблоны текста» в параметрах. Вторая — пустой список файлов шаблонов или недоступность файла: файл переместили, удалили или сетевая папка недоступна. Третья — файл .st повреждён или сохранён в неправильной кодировке после ручного редактирования в стороннем редакторе. Четвёртая — курсор находится не в модуле встроенного языка, а в обычном текстовом документе или поле формы.

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

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

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

Список шаблонов по Ctrl+Q

Норма

Открывается окно с перечнем шаблонов, фильтрация работает

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

Окно пустое или не открывается — проверьте флажок и файлы .st

Автоподстановка сокращения

Норма

После ввода сокращения и пробела текст разворачивается в конструкцию

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

Сокращение остаётся как есть — проверьте опцию автозамены

Доступность файла .st

Норма

Файл открывается по указанному пути, список в настройках без ошибок

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

Путь недоступен или файл не читается — укажите корректный путь

Ограничения и частые ошибки

Шаблоны текста работают только в конфигураторе при редактировании модулей. В режиме 1С:Предприятие, во внешних редакторах кода и в EDT механизм либо отсутствует, либо реализован иначе: в 1C:EDT используется собственная система шаблонов, и файлы .st туда напрямую не переносятся. Если команда переходит на EDT, шаблоны придётся пересоздавать в формате среды разработки.

Ручное редактирование файла .st в стороннем текстовом редакторе — частый источник проблем. Изменение кодировки или случайное повреждение служебных конструкций делает файл нечитаемым для конфигуратора, и весь набор шаблонов пропадает. Перед ручной правкой делайте копию файла, а по возможности редактируйте шаблоны встроенными средствами.

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

Когда шаблоны не помогут: альтернативы

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

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

Что использовать вместо или вместе с шаблонами

Шаблоны текста (.st)

Быстрый ввод типовых конструкций в модулях конфигуратора. Не работают вне модулей и в EDT.

Общие модули

Повторно используемая логика в одном месте. Требуют проектирования, но исключают дублирование кода.

Шаблоны 1C:EDT

Аналог механизма для среды разработки EDT. Формат несовместим с .st, шаблоны создаются заново.

Частые вопросы

Где взять стандартный файл шаблонов, если список пуст?

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

Работают ли шаблоны текста в режиме 1С:Предприятие?

Нет. Механизм шаблонов доступен только в конфигураторе при редактировании модулей встроенного языка. В пользовательском режиме, в полях ввода форм и в отчётах подстановка по Ctrl+Q не срабатывает.

Можно ли подключить несколько файлов шаблонов одновременно?

Да, список в параметрах позволяет добавить несколько файлов .st. Все шаблоны из подключённых файлов объединяются в общий список по Ctrl+Q. Следите, чтобы сокращения в разных файлах не совпадали, иначе поведение подстановки станет неоднозначным.

Почему после обновления платформы шаблоны перестали работать?

Чаще всего сбрасывается флажок «Использовать шаблоны текста» или меняются пути к файлам .st, если обновление изменило структуру каталогов. Откройте Сервис → Параметры → Тексты модулей → Шаблоны текста, проверьте флажок и актуальность путей, при необходимости добавьте файлы заново.

Переносятся ли шаблоны .st в 1C:EDT?

Нет, напрямую файлы .st в EDT не импортируются: там действует собственная система шаблонов кода. Часто используемые конструкции придётся пересоздать в формате EDT вручную или через механизм шаблонов среды.

Как поделиться своими шаблонами с коллегами?

Сохраните шаблоны в отдельный файл .st, разместите его в общей сетевой папке или системе контроля версий и попросите коллег подключить файл через Сервис → Параметры → Шаблоны текста. При обновлении файла достаточно заменить его — конфигуратор подхватит новую версию после перезапуска.