Разработка и Конфигурация · 10 мин
Как открыть синтакс-помощник в 1С
Как открыть синтакс-помощник в 1С: горячие клавиши, меню конфигуратора, контекстный поиск по коду, настройка разделов и решение типичных проблем со справкой.
Синтакс-помощник — встроенная справочная система конфигуратора 1С, которая содержит описание всех объектов встроенного языка, их методов, свойств и событий. Без него разработка и доработка конфигураций практически невозможны: именно здесь разработчик уточняет параметры методов, смотрит примеры кода и проверяет, в каких контекстах (тонкий клиент, веб-клиент, сервер) доступен тот или иной программный объект.
Открыть синтакс-помощник можно несколькими способами: через главное меню конфигуратора, сочетанием клавиш, из контекстного меню модуля и через панель инструментов. Каждый вариант удобен в своей ситуации — например, контекстный вызов сразу показывает описание метода, на котором стоит курсор, а открытие через меню подходит для самостоятельного изучения разделов.
Ниже разобраны все рабочие способы вызова справки, настройка её содержимого, приёмы быстрого поиска и решения типичных проблем — от пустого окна помощника до отсутствующих разделов.
Что такое синтакс-помощник и когда он нужен
Синтакс-помощник — это офлайн-справка по встроенному языку 1С, поставляемая вместе с платформой. Она не требует интернета и всегда соответствует версии установленной платформы, что важно: описание методов в интернете может относиться к другому релизу, а помощник показывает именно вашу версию.
Справочник содержит иерархическое дерево разделов: общие объекты, прикладные типы (справочники, документы, регистры), работа с запросами, файловые операции, сериализация и другие темы. Для каждого метода указаны синтаксис вызова, параметры, возвращаемое значение, доступность по клиентам и пример использования.
Обращаться к помощнику стоит в трёх ситуациях: когда вы не помните точный синтаксис метода, когда нужно проверить доступность объекта на тонком или веб-клиенте, и когда изучаете новый для себя механизм платформы — например, работу с HTTP-запросами или СКД.
Открытие через главное меню конфигуратора
Классический способ — вызов через меню. Запустите конфигуратор, откройте нужную информационную базу и в главном меню выберите пункт «Справка», затем «Синтакс-помощник». Окно справки откроется в правой части рабочей области конфигуратора в виде панели с деревом разделов и областью просмотра.
Этот способ удобен, когда вы хотите изучить раздел целиком: например, последовательно просмотреть все методы работы со строками или с массивами. Дерево разделов раскрывается кликом по значку «плюс» или двойным щелчком по узлу.
Панель помощника можно закрепить, свернуть или перетащить в другое место окна конфигуратора — положение сохраняется между сеансами. Если панель мешает, её можно временно скрыть крестиком в заголовке панели; при следующем вызове она появится снова.
Быстрый вызов сочетаниями клавиш
Разработчики, которые много работают с кодом, почти всегда используют горячие клавиши — это самый быстрый способ. Основные сочетания для работы со справкой в конфигураторе:
- Ctrl+Shift+F1 — открыть синтакс-помощник с корневого уровня (дерево разделов);
- Ctrl+F1 — контекстный вызов: открыть описание элемента, на котором стоит курсор в модуле;
- F1 — общая справка по текущему окну или элементу интерфейса.
Сочетание Ctrl+F1 особенно продуктивно: поставьте курсор на имя любого метода встроенного языка — например, НайтиПоКоду или СтрНайти — и нажмите Ctrl+F1. Помощник откроется сразу на странице этого метода, без ручного поиска по дереву.
- 1Откройте модуль с кодом в конфигураторе
- 2Установите курсор на имя метода или объекта встроенного языка
- 3Нажмите Ctrl+F1
- 4Убедитесь, что в панели помощника открылась страница именно этого элемента
- 5Если открылся корень дерева — проверьте, что курсор стоит на элементе встроенного языка, а не на пользовательской процедуре
Контекстный поиск из модуля
Помимо горячих клавиш, контекстная справка доступна через меню правой кнопки мыши. Кликните правой кнопкой по имени метода в тексте модуля и выберите пункт «Синтакс-помощник» или аналогичный пункт контекстной справки — откроется описание выбранного элемента.
Важное ограничение: контекстный переход работает только для объектов и методов встроенного языка платформы. Если курсор стоит на процедуре общего модуля вашей конфигурации, помощник не найдёт такой элемент — он описывает только платформу, а не прикладной код. Для навигации по собственному коду используйте поиск процедур и функций (Ctrl+O или соответствующий пункт меню, в зависимости от версии).
Если метод относится к объекту с уточняющим контекстом (например, методы табличной части документа), помощник может предложить несколько вариантов страниц — выберите ту, что соответствует вашему типу объекта.
Настройка содержимого синтакс-помощника
По умолчанию помощник показывает все разделы платформы, и дерево получается очень большим. Его можно сократить до нужных режимов работы. В верхней части панели помощника есть кнопка настройки содержимого (значок с изображением списка) — через неё открывается окно выбора разделов.
Отметьте только те режимы, в которых работает ваша конфигурация: например, «Тонкий клиент» и «Сервер». Разделы, недоступные в этих режимах, будут скрыты из дерева, и поиск станет быстрее и чище. Это также снижает риск ошибочно использовать метод, недоступный на нужном клиенте.
Дополнительно в помощнике работает полнотекстовый поиск: вкладка «Поиск» в панели позволяет найти все страницы, где встречается заданное слово. Для точного поиска по имени метода удобнее вкладка «Индекс» — начните вводить имя, и список отфильтруется автоматически.
| Режим работы | Что даёт | Когда использовать |
|---|---|---|
| Дерево разделов | Иерархия всех объектов языка | Изучение новой темы, просмотр всех методов объекта |
| Индекс | Алфавитный список с фильтром по вводу | Быстрый поиск метода по известному имени |
| Поиск | Полнотекстовый поиск по всем страницам | Когда известно назначение, но не точное имя метода |
Типичные проблемы и их решение
Иногда синтакс-помощник не открывается или показывает пустое окно. Самая частая причина — повреждённые или неустановленные файлы справки. Проверьте, что при установке платформы был выбран компонент справки, и при необходимости переустановите платформу с полным набором компонентов.
Вторая типичная ситуация — помощник открывается, но Ctrl+F1 не находит метод. Причины: курсор стоит на прикладной процедуре, а не на элементе встроенного языка; либо метод уникален для контекста, который не включён в настройку содержимого помощника. Расширьте набор разделов в настройке содержимого и повторите попытку.
Третья проблема — помощник открывается на английском языке или в непривычном виде. Язык справки зависит от языка интерфейса платформы; переключите язык конфигуратора или проверьте, какие языковые пакеты установлены. Также учтите: в разных версиях платформы состав методов различается, поэтому для старой базы смысл имеет открывать помощник той версии платформы, на которой она работает.
Как проверить результат
Открывается панель с деревом разделов встроенного языка
Ничего не происходит или открывается пустое окно — проверьте установку компонентов справки
Открывается страница именно этого метода с синтаксисом и примером
Открывается корень дерева — курсор не на элементе встроенного языка
В описании указан нужный вам клиент (тонкий, веб, сервер)
Нужный клиент в списке отсутствует — метод в нём работать не будет
Альтернативы и дополнительные источники
Синтакс-помощник — основной, но не единственный источник справки по языку 1С. Портал ИТС содержит документацию разработчика с расширенными примерами и описанием типовых приёмов; он требует действующей подписки ИТС. Для экзотических сценариев полезна документация, поставляемая в составе конкретной конфигурации.
Внутри конфигуратора дополнительно работает подсказка при наборе кода: после точки у имени объекта появляется список доступных методов и свойств (контекстная подсказка), а при вводе параметров метода показывается их подсказка. Это быстрее, чем открывать помощник, когда нужно лишь вспомнить порядок параметров.
Практичный подход — комбинировать инструменты: контекстная подсказка для скорости набора, Ctrl+F1 для уточнения деталей метода, ИТС и документация конфигурации — для прикладных механизмов, которых нет в помощнике.
Сравнение вариантов справки
Офлайн, точно соответствует версии платформы; ограничение — только встроенный язык, без прикладных механизмов
Мгновенно при наборе кода; показывает только список методов и параметры, без подробных описаний и примеров
Расширенные примеры и прикладные решения; требует интернета и подписки ИТС, версия может отличаться от вашей платформы
Что важно запомнить
Синтакс-помощник открывается через меню «Справка → Синтакс-помощник», клавишами Ctrl+Shift+F1 (общий вызов) и Ctrl+F1 (описание метода под курсором). Настройте состав разделов под свои режимы работы, проверяйте доступность методов по клиентам и помните: помощник описывает только платформу, а не прикладной код.
Частые вопросы
Чем отличается Ctrl+F1 от Ctrl+Shift+F1?
Ctrl+Shift+F1 открывает синтакс-помощник с корня дерева разделов — подходит для самостоятельного изучения. Ctrl+F1 работает контекстно: если курсор в модуле стоит на методе встроенного языка, откроется сразу страница этого метода.
Почему синтакс-помощник открывается пустым?
Чаще всего при установке платформы не были установлены файлы справки или они повреждены. Переустановите платформу, отметив компонент справки, либо запустите установку в режиме изменения состава компонентов.
Можно ли открыть синтакс-помощник в режиме 1С:Предприятие?
Нет, синтакс-помощник — инструмент конфигуратора и предназначен для разработчиков. В пользовательском режиме доступна только общая справка по работе с программой через меню «Справка».
Почему Ctrl+F1 не находит мой метод?
Помощник описывает только встроенный язык платформы. Если курсор стоит на процедуре общего модуля или вашей функции, справки по ней не будет. Также проверьте настройку содержимого помощника — нужный раздел может быть отключён.
Как узнать, работает ли метод в веб-клиенте?
Откройте страницу метода в синтакс-помощнике и найдите блок доступности: там перечислены режимы (тонкий клиент, веб-клиент, сервер, толстый клиент, мобильное приложение), в которых элемент доступен. Если нужного режима нет в списке — метод в нём не работает.
Соответствует ли помощник моей версии платформы?
Да, синтакс-помощник устанавливается вместе с платформой и описывает именно её версию. Если вы работаете с базой на другой версии платформы, открывайте конфигуратор той версии — иначе описание методов может отличаться.