Разработка и Конфигурация · 10 мин
Как включить шаблон текста в 1С
Как включить шаблоны текста в 1С: включение подстановки, работа с файлами .st, сочетание Ctrl+Q, создание собственных шаблонов и решение типичных проблем.
Шаблоны текста в 1С — это готовые заготовки кода, которые конфигуратор подставляет автоматически: достаточно набрать несколько букв и нажать комбинацию клавиш, чтобы получить развёрнутую конструкцию — цикл, условие, описание процедуры. Механизм встроен в платформу и работает в модуле любого объекта: общего модуля, формы, документа или отчёта.
По умолчанию автоподстановка шаблонов может быть отключена, либо файлы шаблонов не подключены к конфигуратору — из-за этого сочетание Ctrl+Q не срабатывает, и у пользователя возникает вопрос, как включить функцию. Ниже разобраны все шаги: от проверки настроек до создания собственных шаблонов и исправления типичных проблем.
Материал ориентирован на работу в конфигураторе платформы 1С:Предприятие 8.3. Внешний вид окон может немного отличаться между версиями платформы, но логика настройки сохраняется.
Что такое шаблоны текста и где они применяются
Шаблон текста — это фрагмент кода с заранее заданной структурой. Например, шаблон «Если» разворачивается в полную конструкцию «Если … Тогда … КонецЕсли;», а шаблон «Процедура» создаёт заготовку с описанием, заголовком и окончанием процедуры. Курсор автоматически встаёт в позицию, где нужно ввести переменную часть.
Шаблоны хранятся в файлах с расширением .st. Платформа поставляется со стандартным набором, который обычно находится в каталоге установки (например, в подкаталоге bin\tmplts). Помимо стандартных, можно подключать свои файлы — например, корпоративные шаблоны, принятые в команде разработки.
Использовать шаблоны можно только в текстовых модулях конфигуратора. В полях ввода форм, в режиме «Предприятие» и в редакторе запросов механизм Ctrl+Q не работает — там действуют собственные средства подсказки.
Включение контекстной подсказки и автоподстановки
Основная настройка находится в параметрах конфигуратора. Откройте меню Сервис → Параметры, перейдите на вкладку Модули и выберите раздел Контекстная подсказка. Здесь собраны переключатели, управляющие подстановкой шаблонов, ключевых слов и свойств объектов.
Убедитесь, что включены опции автоматической подстановки при наборе текста и подстановка по Ctrl+Q. Если флажки сняты, шаблоны не будут разворачиваться ни автоматически, ни по комбинации клавиш. После изменения настроек нажмите «ОК» — перезапуск конфигуратора обычно не требуется.
- 1Откройте конфигуратор и меню «Сервис → Параметры».
- 2Перейдите на вкладку «Модули», раздел «Контекстная подсказка».
- 3Включите автоматическую подстановку шаблонов и подстановку по Ctrl+Q.
- 4Нажмите «ОК» и проверьте работу в любом модуле.
Проверить результат просто: откройте любой общий модуль, наберите слово «проц» и нажмите Ctrl+Q. Если настройка активна, появится список подходящих шаблонов либо сразу развернётся заготовка процедуры.
Подключение файлов шаблонов
Даже при включённой подсказке шаблоны могут не работать, если к конфигуратору не подключён ни один файл .st. Это типичная ситуация после новой установки платформы или при работе под другим пользователем Windows.
Откройте окно шаблонов через меню Сервис → Шаблоны текста. Затем в панели шаблонов нажмите кнопку Действия → Настройка шаблонов. В открывшемся окне добавьте нужные файлы: стандартный файл из каталога платформы и, при необходимости, собственные файлы шаблонов.
Обратите внимание на флажок использования стандартных шаблонов в том же окне настройки — если он снят и своих файлов нет, список шаблонов окажется пустым. После добавления файлов закройте окно и снова проверьте подстановку в модуле.
Как пользоваться шаблонами в модуле
Базовый сценарий: наберите начало имени шаблона (например, «для», «если», «пока») и нажмите Ctrl+Q. Если вариант один — он развернётся сразу; если несколько — появится список для выбора стрелками и Enter.
После разворачивания курсор встаёт в первую редактируемую позицию (место для условия, имени переменной и т. п.). Введите значение и нажмите Enter или Tab, чтобы перейти к следующей изменяемой части шаблона. Так можно заполнить всю конструкцию, не трогая мышь.
Альтернативный способ — перетащить шаблон мышью из панели «Шаблоны текста» прямо в нужное место модуля. Это удобно, когда вы не помните точное имя шаблона и хотите выбрать его визуально из дерева.
Если автоподстановка мешает — например, разворачивает шаблон, когда вы просто хотели закончить слово, — отключите в параметрах автоматическую подстановку, оставив только вызов по Ctrl+Q. Так шаблоны будут срабатывать исключительно по явной команде.
Создание собственного шаблона
Стандартный набор покрывает базовые конструкции, но на практике удобно добавить свои заготовки: типовой обработчик ошибки, шапку процедуры с комментарием по стандарту компании, фрагмент обращения к запросу.
Откройте «Сервис → Шаблоны текста», в панели нажмите Действия → Новый файл (или добавьте шаблон в существующий файл через «Добавить»). Задайте имя шаблона — именно по его началу будет работать подстановка — и введите текст заготовки. Для обозначения редактируемых позиций используется специальный синтаксис с угловыми скобками, который платформа подсвечивает при вставке.
Сохраните файл .st в доступном месте — например, в общей папке команды, если шаблоны должны быть у всех разработчиков. После сохранения новый шаблон сразу доступен для подстановки по Ctrl+Q.
Стандартные и собственные шаблоны
Подходят для базовых конструкций языка; обновляются вместе с платформой, редактировать их напрямую не рекомендуется.
Позволяют закрепить корпоративные стандарты кода; требуют ручного распространения между разработчиками и контроля версий файла.
Типичные проблемы и их решение
Чаще всего жалоба звучит так: «Ctrl+Q не работает». Причин несколько, и проверять их стоит по порядку: включена ли контекстная подсказка в параметрах, подключены ли файлы .st, не перехвачена ли комбинация клавиш другой программой (некоторые утилиты и раскладки клавиатуры занимают Ctrl+Q).
Вторая ситуация — шаблон разворачивается, но не тот, который ожидался. Это значит, что набранное начало слова совпадает с несколькими шаблонами, и платформа выбрала первый по списку. Наберите имя точнее или выберите нужный вариант из выпадающего списка.
Третья проблема — пустая панель шаблонов после обновления платформы. Путь к стандартному файлу мог измениться вместе с каталогом новой версии: откройте настройку шаблонов и заново укажите файл из актуального каталога установки.
Как проверить результат
Шаблон разворачивается, курсор встаёт в редактируемую позицию
Ничего не происходит или появляется пустой список
В дереве видны стандартные и собственные шаблоны
Панель пуста — файлы .st не подключены
После ввода начала имени появляется подсказка
Подсказки нет — проверьте параметры контекстной подсказки
Ограничения и безопасная работа
Шаблоны влияют только на удобство набора кода и не меняют логику конфигурации сами по себе. Однако файл .st — обычный текстовый файл в специальном формате: его случайное повреждение (например, правка в стороннем редакторе с нарушением структуры) приведёт к тому, что шаблоны из него перестанут загружаться.
Перед правкой собственного файла шаблонов делайте его копию. Не храните единственную версию файла в каталоге платформы или во временных папках — используйте отдельный каталог с резервным копированием, особенно если шаблонами пользуется вся команда.
FAQ
Почему Ctrl+Q не срабатывает, хотя подсказка включена?
Проверьте, подключён ли хотя один файл шаблонов в «Сервис → Шаблоны текста → Действия → Настройка шаблонов». Также убедитесь, что комбинацию не перехватывает сторонняя программа — попробуйте вызвать подстановку через контекстное меню редактора модуля.
Работают ли шаблоны текста в режиме «Предприятие»?
Нет. Механизм доступен только в конфигураторе при редактировании модулей. В пользовательском режиме для ускорения ввода используются другие средства, например подстановки в полях ввода.
Как перенести свои шаблоны на другой компьютер?
Скопируйте файл .st на новое рабочее место и подключите его через настройку шаблонов. Сами настройки конфигуратора привязаны к профилю пользователя, поэтому простое копирование файла без подключения эффекта не даст.
Можно ли изменить стандартные шаблоны платформы?
Технически файл доступен для правки, но делать этого не стоит: при обновлении платформы изменения будут перезаписаны. Правильный путь — создать собственный файл .st и добавить в него нужные варианты шаблонов.
Шаблон разворачивается не полностью или с ошибкой — в чём причина?
Скорее всего, нарушена структура самого шаблона: например, потерян управляющий символ или незакрыта редактируемая позиция. Откройте шаблон на редактирование в панели шаблонов и сверьте его с работающими аналогами.
Нужно ли перезапускать конфигуратор после изменения настроек?
Как правило, нет: включение контекстной подсказки и подключение файлов шаблонов применяются сразу. Перезапуск может понадобиться лишь в редких случаях, если конфигуратор продолжает вести себя по старым настройкам.
Что важно запомнить
Шаблоны текста включаются в два шага: активируйте контекстную подсказку в параметрах конфигуратора и подключите файлы .st через окно «Шаблоны текста». Работает механизм только в модулях конфигуратора, вызывается по Ctrl+Q, а собственные шаблоны храните в отдельном файле с резервной копией.