1C: Platform tools

Расширение для Visual Studio Code с инструментами разработки для экосистемы 1С. Предоставляет удобный интерфейс для работы с проектами 1С через панель команд и дерево задач.

• Установка
• Настройка
• Инициализация проекта

Возможности

Откройте панель «1C: Platform tools» в боковой панели VS Code. Все команды организованы по категориям.

В дереве доступны следующие разделы:

• Избранное — быстрый доступ к выбранным командам (отображается вверху при наличии избранных)
• Информационные базы — операции с ИБ
• Конфигурация — загрузка, выгрузка, сборка и разбор конфигурации
• Расширения — работа с расширениями конфигурации
• Внешние файлы — сборка и разбор обработок и отчётов
• Зависимости — инициализация проекта (packagedef, структура), настройка Git, установка OneScript/OPM, установка и удаление зависимостей
• Запуск — запуск Предприятия и Конфигуратора
• Тестирование — XUnit, синтаксический контроль, Vanessa, Allure
• Установить версию — установка версии конфигурации, расширений, отчётов и обработок
• Задачи (oscript) — запуск задач из каталога tasks (OneScript)
• Задачи (workspace) — задачи из tasks.json и конфигурации из launch.json

Избранное

Можно добавить любые команды в избранное для быстрого доступа:

1. Вызовите команду «Настроить избранное» из палитры команд (Ctrl+Shift+P → «1C: Дерево: Настроить избранное») или через контекстное меню заголовка панели.
2. В открывшемся списке отметьте нужные команды (в том числе с параметрами: конкретное расширение, отчёт, обработка или задача oscript).
3. Избранные команды появятся в секции «Избранное» вверху дерева и сохраняются между сессиями.

Команды также доступны через палитру команд (Ctrl+Shift+P → введите «1C»).

Список дел (TODO)

В нижней панели VS Code доступна вкладка «Список дел»: поиск в коде комментариев-меток (TODO, FIXME, XXX, HACK, BUG) и отображение в виде дерева.

• Открытие: кнопка «Список дел (TODO)» в заголовке панели «1C: Platform tools» или команда из палитры.
• Группировка: по файлам или плоский список (кнопка «Группировать по иерархии (файлам)»).
• Фильтры:
  • по тегу — один или несколько тегов (кнопка «Фильтр по тегу»);
  • по области — весь проект, текущий открытый файл или по типу файла (Markdown, BSL, OScript, Feature);
  • кнопка «Сбросить фильтры» снимает оба фильтра.
• Клик по элементу открывает файл на указанной строке.

Файлы по умолчанию: *.bsl, *.os, *.md, *.feature.

Панель «Проекты 1С»

На боковой панели (Activity Bar) доступна панель «Проекты 1С» для быстрого переключения между проектами.

• Избранное — сохранённые проекты с тегами (Личное, Работа и др.), группировка по тегам или плоский список
• Все проекты — автообнаружение проектов 1С по каталогам (ищет packagedef в указанных папках)
• Статусная строка — отображает текущий проект; клик открывает QuickPick выбора
• QuickPick — команда «Открыть список проектов 1С» (Ctrl+Alt+P / Cmd+Alt+P) для быстрого выбора из палитры

Требования

• Visual Studio Code версии 1.103.0 или выше
• Интернет

Установка

1. Откройте VS Code
2. Перейдите в раздел Extensions (Ctrl+Shift+X)
3. Найдите "1C: Platform tools"
4. Нажмите "Install"

Настройка

Расширение автоматически активируется при открытии проекта 1С (наличие файла packagedef в корне проекта).

Настройки панели «Проекты 1С»

Настройки поиска и отображения проектов находятся в 1c-platform-tools.projects:

Пример настройки каталогов поиска:

{
  "1c-platform-tools.projects.baseFolders": [
    "~/projects",
    "D:/work/1c"
  ]
}

Инициализация проекта

Если в открытой папке ещё нет файла packagedef, панель «1C: Platform tools» не отображается, но команды доступны из палитры команд (Ctrl+Shift+P). Выполните «1C: Зависимости: Инициализировать проект» — будет создан файл packagedef из шаблона. После успешного создания расширение активируется полностью: панель и дерево команд не появятся без перезагрузки окна. Если вызвать любую другую команду расширения без открытого проекта 1С, будет показано информационное сообщение с подсказкой использовать эту команду.

В разделе «Зависимости» также доступны:

• Инициализировать структуру проекта — создание каталогов по шаблону vanessa-bootstrap
• Настроить Git — имя и email, область (проект/глобально), алиасы и параметры; опционально — настройки с правами администратора (core.longpaths, LC_ALL)
• Установить OneScript — установка OneScript через OVM (версия из packagedef или stable)
• Установить пакетный менеджер OneScript — установка менеджера пакетов
• Установить зависимости / Удалить зависимости — работа с packagedef и каталогом oscript_modules

Логирование

Расширение пишет логи в панель Output (Вид → Вывод), канал «1C: Platform tools». Уровень детализации задаётся в настройках:

• Настройка: 1c-platform-tools.logLevel
• Значения: error (только ошибки), warnings (ошибки и предупреждения), info (по умолчанию), debug (полный вывод для диагностики)

При сбое команды откройте Output → «1C: Platform tools», при необходимости установите уровень debug, воспроизведите проблему и приложите логи к отчёту об ошибке.

Настройки доступны через File > Preferences > Settings (или Ctrl+,) и поиск "1C: Platform tools". Параметры подключения к информационной базе настраиваются в файле env.json в корне проекта:

{
  "default": {
    "--ibconnection": "/F./build/ib"
  }
}

Структура проекта

Расширение опирается на структуру каталогов проекта vanessa-bootstrap — шаблона правильной разработки на платформе 1С:Предприятие 8.

Рекомендуемая структура проекта:

project/
├── build/
│   ├── ib/                 # Информационная база
│   └── out/                # Собранные файлы
├── src/
│   ├── cf/                 # Исходники конфигурации
│   ├── cfe/                # Исходники расширений
│   ├── epf/                # Исходники внешних обработок
│   └── erf/                # Исходники внешних отчетов
├── oscript_modules/        # Зависимости (устанавливаются через OPM)
├── env.json                # Настройки подключения к ИБ
└── packagedef              # Файл для активации расширения

Работа с Docker

Расширение поддерживает выполнение команд vrunner через Docker-контейнеры. Это полезно для работы в окружениях без локальной установки платформы 1С (например, GitHub Codespaces).

Подготовка Docker-образа:

Docker-образы для работы с платформой 1С и vanessa-runner можно собрать из репозитория pravets/onec-images:

1. Форкните репозиторий pravets/onec-images
2. Следуйте инструкциям в репозитории для сборки образа vrunner
3. Опубликуйте собранный образ в ваш Docker registry (Docker Hub, GitHub Container Registry и т.д.)

Настройка Docker в расширении:

1. Включите Docker-режим: 1c-platform-tools.docker.enabled = true
2. Укажите Docker-образ: 1c-platform-tools.docker.image = "your-registry/vrunner:8.3.27.1786"

Важно:

• Docker-образ должен содержать установленную платформу 1С:Предприятие и vanessa-runner

• При использовании Docker параметр --ibcmd используется автоматически (так как в Docker нет GUI)

• Пути автоматически нормализуются для Docker-окружения (/F./build/ib → /F./workspace/build/ib)

• Ограничение: В Docker можно выполнять только команды, которые поддерживают --ibcmd:

  • [x] Операции с информационными базами (init-dev, update-dev, dump, restore, dump-dt, load-dt)
  • [x] Операции с конфигурацией (load, dump, dumpcf, compile, decompile)
  • [x] Операции с расширениями (compileext, decompileext, unloadext, compileexttocfe)
  • [x] Операции с внешними файлами (compileepf, decompileepf)
  • [ ] Запуск приложений (run, designer) - требуют GUI
  • [ ] Тестирование (xunit, syntax-check, vanessa) - могут требовать GUI

  При попытке выполнить команду, которая не поддерживает --ibcmd, расширение покажет предупреждение.

Важные нюансы

• Панель «Проекты 1С»: настройте baseFolders для автообнаружения проектов; без указания папок вкладка «Все проекты» будет пустой
• Все команды выполняются в терминале VS Code для видимости вывода
• Расширение автоматически ищет vrunner.bat в oscript_modules/bin/ проекта
• Параметр --ibconnection берется из env.json (секция default['--ibconnection'], по умолчанию /F./build/ib)
• Все пути к файлам внутри workspace должны быть относительными
• Для использования ibcmd требуется установка платформы 1С:Предприятие с компонентом "Сервер 1С: Предприятия 8" (настройка 1c-platform-tools.useIbcmd)
• При использовании Docker (docker.enabled = true) параметр --ibcmd используется автоматически
• Инициализация: без файла packagedef панель скрыта; команда «1C: Зависимости: Инициализировать проект» из палитры создаёт проект и сразу включает панель без перезагрузки
• Логи: диагностика и ошибки пишутся в Output → «1C: Platform tools»; уровень задаётся настройкой 1c-platform-tools.logLevel (info по умолчанию, debug для детального разбора)

Для разработчиков

Если вы хотите внести вклад в проект или разработать собственные команды, ознакомьтесь с документацией для разработчиков.

Лицензия

MIT License. Подробности см. в файле LICENSE.

Автор

Ivan Karlo (i.karlo@outlook.com)

При желании, отблагодарить автора можно по ссылке:

• Boosty
• Сбор в Т-банк