Контекстная подсказка в Конфигураторе 1С 8.3: настройка, клавиши, почему не появляется

· 9 мин

Содержание

Подсказки в Конфигураторе 1С включаются в Сервис → Параметры, вкладка «Модули», подвкладка «Контекстная подсказка». Если окно не всплывает само, вызвать его вручную можно в любой момент сочетанием Ctrl+Space, а подсказку по параметрам метода — Ctrl+Shift+Space.

Когда подсказка пропадает при включённых настройках, причина почти всегда в одном из пяти мест: курсор стоит в строке или комментарии, выше в модуле синтаксическая ошибка, Конфигуратор не знает тип переменной, сочетание клавиш перехвачено Windows или другой программой, либо объект недоступен в текущем контексте (клиент/сервер).

Где включаются подсказки в параметрах Конфигуратора

Все настройки редактора модулей собраны в одном окне. Порядок такой:

  1. Откройте базу в режиме Конфигуратора и откройте конфигурацию (Конфигурация → Открыть конфигурацию) — без открытой конфигурации модули редактировать нельзя.
  2. Выберите в главном меню Сервис → Параметры.
  3. Перейдите на вкладку «Модули».
  4. Откройте подвкладку «Контекстная подсказка».
  5. Включите флажки автоматического показа подсказки при вводе и подсказки по параметрам. Задайте задержку перед появлением окна.
  6. Нажмите «ОК». Перезапуск не нужен: настройки действуют в открытых модулях сразу.

Задержку подбирают под себя. Если окно мешает и выскакивает на каждой букве, увеличьте её. Если приходится ждать, уменьшите.

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

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

Что ещё полезно включить на вкладке «Модули»

  • 🧩 Группировка — сворачивание процедур, условий и циклов. В длинных модулях форм это экономит прокрутку и помогает быстрее найти место, где подсказка «сломалась».
  • ✅ Проверка — автоматическая проверка синтаксиса. Ошибки видны раньше, а значит, раньше восстанавливается и подсказка.
  • ✍️ Редактирование — автоматические отступы и поведение клавиши Tab. Ровные отступы сами по себе подсказку не включают, но упрощают поиск незакрытого КонецЕсли.

Почему не всплывает подсказка: диагностика по шагам

Начните с простого теста. Откройте любой модуль, напишите на новой строке Сообщить( и нажмите Ctrl+Shift+Space. Если подсказка по параметрам появилась — редактор исправен, проблема в конкретном месте кода. Если нет ничего — проблема в настройках или в клавишах.

Диагностика: выберите симптом

Синтаксическая ошибка выше по модулю

Это самая частая причина, когда подсказка «то есть, то нет». Редактор разбирает модуль сверху вниз. Незакрытый КонецПроцедуры, лишняя кавычка или скобка — и всё, что ниже, для него превращается в нераспознанный текст.

Проверка синтаксиса вызывается сочетанием Ctrl+F7. В окне служебных сообщений появится список ошибок. Двойной щелчок по строке переводит курсор к месту ошибки. Исправляйте первую: следующие часто являются её следствием.

Неизвестный тип переменной

Конфигуратор угадывает тип только там, где он виден из кода. Сравните:

Запрос = Новый Запрос;
Запрос.   // подсказка покажет Текст, УстановитьПараметр, Выполнить...

Процедура Заполнить(Параметр)
    Параметр.   // пусто: тип параметра неизвестен
КонецПроцедуры

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

Курсор в строке или комментарии

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

Клиентский и серверный контекст

В модулях управляемых форм подсказка учитывает директиву компиляции. В процедуре с &НаКлиенте вы не увидите Справочники, Документы, Запрос — на клиенте они недоступны. Это не сбой, а защита от кода, который не скомпилируется. Решение — вынести обращение к базе в процедуру &НаСервере или &НаСервереБезКонтекста.

Горячие клавиши для ручного вызова подсказки

Автопоказ срабатывает не всегда, поэтому ручной вызов стоит держать в пальцах. Сочетания одинаковы в Конфигураторе 8.3 последних лет:

СочетаниеЧто делаетКогда пригодится
Ctrl+SpaceСписок доступных слов, методов, свойств в позиции курсораНачали набирать имя и не помните окончание
Ctrl+Shift+SpaceПодсказка по параметрам методаКурсор внутри скобок, нужно вспомнить порядок параметров
Ctrl+QВыбор шаблона текстаБыстро вставить заготовку цикла, условия, процедуры
Ctrl+F1Поиск слова под курсором в Синтакс-помощникеНужно полное описание метода с примерами
F12Переход к определению процедуры или функцииПосмотреть, что принимает своя процедура
Ctrl+F7Проверка синтаксиса модуляПодсказка пропала ниже какого-то места

Пара практических приёмов:

  • ⌨️ Наберите первые 2–3 буквы и нажмите Ctrl+Space. Если вариант один, редактор сразу его подставит, без открытия списка.
  • 🔁 При выборе из списка Enter вставляет выбранное слово. Для методов скобки дописываются автоматически, курсор встаёт внутрь — сразу жмите Ctrl+Shift+Space, чтобы увидеть параметры.
  • 🧭 После Новый с пробелом подсказка покажет список типов, которые можно создать конструктором. Удобно, когда не помните точное имя типа.

Если Ctrl+Space переключает раскладку, проверьте Параметры Windows → Время и язык → Язык → Клавиатура → Сочетания клавиш для языков ввода. Сочетание для смены языка ввода не должно совпадать с Ctrl+Space. Затем проверьте Punto Switcher и аналогичные программы.

Разные версии платформы и среда EDT

Подсказка есть во всех версиях Конфигуратора 8.3, но её «понятливость» росла от релиза к релизу. В свежих версиях платформы она точнее определяет типы, лучше работает в модулях форм и учитывает экспортные методы общих модулей.

Что стоит знать:

  • 📦 Общие модули. После ИмяОбщегоМодуля. подсказка покажет только экспортные процедуры и функции — те, что объявлены со словом Экспорт. Не видите свою процедуру — проверьте это слово и флажки контекста в свойствах общего модуля (клиент, сервер, вызов сервера).
  • 🔄 Версия платформы и конфигурации. Если конфигурация разработана под более новую платформу, чем у вас установлена, часть возможностей редактора может работать иначе. Для типовых решений сверяйте требования к номеру платформы в описании релиза: номер установленной платформы должен быть не ниже указанного.
  • 🧪 1С:EDT. В среде Enterprise Development Tools подсказка опирается на описания процедур в комментариях: если над процедурой указаны параметры с типами, EDT подсказывает их свойства внутри процедуры. Если ваша команда пишет много нетипизированного кода, это ощутимое преимущество.

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

Шрифт и цвета кода, чтобы подсказку было удобно читать

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

Шрифт

Шрифт и размер табуляции задаются в Сервис → Параметры, на вкладке «Тексты». Для кода удобен моноширинный шрифт:

  • 🔤 Consolas — есть в любой современной Windows, хорошо различает 0 и O, 1 и l.
  • 🔤 Courier New — запасной вариант, но выглядит бледнее.
  • 🔤 Размер 10–11 пт на мониторе Full HD, 12–13 пт на 2K и 4K при масштабе 100%.

Цвета синтаксиса

Цвета элементов языка настраиваются на вкладке «Модули» — в списке перечислены ключевые слова, комментарии, строки, числа, операторы и другие элементы (расположение списка может отличаться в зависимости от версии платформы). Каждому можно задать свой цвет.

Рабочая схема, которую легко настроить за пять минут:

ЭлементЦветЗачем
Ключевые словаТёмно-красный, как по умолчаниюКаркас кода виден сразу
КомментарииЗелёный, приглушённыйНе спорит с кодом
СтрокиТёмно-синий или бордовыйВидно, где текст запроса, а где код
Числа и датыОтличный от строкНе путать "10" и 10

Готовой тёмной темы в Конфигураторе нет. Полностью тёмный вид собирают вручную по элементам, и результат зависит от версии платформы. Если глаза устают, обычно хватает увеличить шрифт и сделать комментарии менее контрастными.

Контекстное меню модуля: что умеет помимо подсказки

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

  • 🧱 Конструктор запроса. Поставьте курсор внутрь строки с текстом запроса или на пустое место и выберите «Конструктор запроса…». Конструктор сам разберёт существующий текст и покажет таблицы, поля, условия. Это заменяет отсутствующую подсказку внутри строк.
  • 🧾 Конструктор запроса с обработкой результата. Создаёт не только текст запроса, но и код выполнения с обходом выборки.
  • 🎯 Перейти к определению. То же, что F12: открывает процедуру, на имени которой стоит курсор, даже если она в общем модуле.
  • 🛠 Рефакторинг. В актуальных версиях платформы в контекстном меню есть подменю рефакторинга. Самое полезное там — создание описания процедуры или функции: редактор вставляет над процедурой шаблон комментария с параметрами, который потом читают коллеги и инструменты.
  • 📚 Синтакс-помощник. Для слова под курсором открывает описание: синтаксис, параметры, доступность на клиенте и сервере, примеры.

Шаблоны текста

Шаблоны — недооценённая часть подсказок. По Ctrl+Q открывается список заготовок: циклы, условия, попытки, процедуры. Свои шаблоны добавляют через Сервис → Шаблоны текста: например, заготовку запроса с обходом выборки, которую вы пишете по десять раз в день.

Запрос = Новый Запрос;
Запрос.Текст = "";
Запрос.УстановитьПараметр("", );
Выборка = Запрос.Выполнить().Выбрать();
Пока Выборка.Следующий() Цикл
    
КонецЦикла;

Такой шаблон вставляется за два нажатия, а объявление Запрос = Новый Запрос сразу даёт рабочую подсказку по методам запроса.

Частые ошибки при настройке подсказок

  • ❌ Ищут настройку в режиме 1С:Предприятие. Подсказки по коду есть только в Конфигураторе (и в EDT). В пользовательском режиме таких параметров нет.
  • ❌ Ждут подсказку по объектам базы в обработке без открытой конфигурации. Внешняя обработка, открытая через Файл → Открыть, редактируется, но подсказка по объектам метаданных работает только при открытой конфигурации базы.
  • ❌ Путают подсказку с Синтакс-помощником. Подсказка — короткий список в позиции курсора. Синтакс-помощник — справочник с описаниями. Если нужен пример использования, открывайте его через Ctrl+F1.
  • ❌ Списывают всё на «глюк платформы». Чаще всего при разборе выясняется, что выше по модулю осталась незакрытая конструкция. Сначала Ctrl+F7, потом всё остальное.
  • ❌ Пишут код до объявления переменной. Если переменная получит значение ниже по тексту, в месте её первого использования тип ещё неизвестен.

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

Работает ли подсказка в модуле внешней обработки?
Да. Методы языка и свойства самой обработки подсказываются всегда. Подсказка по справочникам и документам базы появляется, когда в Конфигураторе открыта конфигурация этой базы.
Почему подсказка не показывает мою процедуру из общего модуля?
Проверьте слово Экспорт в объявлении и флажки контекста в свойствах модуля. Из клиентской процедуры серверный общий модуль без флажка «Вызов сервера» не виден.
Можно ли включить подсказку внутри текста запроса?
В строке модуля — нет, это обычный строковый литерал. Для запросов используйте конструктор запроса из контекстного меню: он показывает таблицы и поля метаданных.
Чем подсказка в EDT лучше, чем в Конфигураторе?
EDT читает типы параметров из комментариев-описаний над процедурами и подсказывает свойства там, где Конфигуратор показывает пустой список. Обычные сочетания клавиш при этом похожи.
Сбрасываются ли настройки подсказки при обновлении платформы?
Как правило, нет: параметры хранятся в профиле пользователя Windows. Слетают они при смене учётной записи, переносе на другой компьютер или очистке профиля.