Расширение VS Code / Cursor

Расширение mussolene.1c-hbk-bsl добавляет в VS Code и Cursor полноценную поддержку BSL. В платформенные VSIX уже включён сервер, поэтому отдельная установка Python или Toolkit обычно не нужна.

Установить из VS Marketplace Скачать VSIX

Требования и первый запуск

1. Используйте VS Code или Cursor с API VS Code 1.85+.
2. Установите расширение.
3. Откройте каталог с файлами .bsl или .os.
4. Дождитесь запуска сервера; найденные нарушения появятся в Problems.

Публикуются отдельные сборки для macOS Apple Silicon, macOS Intel, Linux x64 и Windows x64.

Возможности

Область	Возможности
Код	подсветка синтаксиса и семантическая подсветка
Диагностика	180 правил, панель Problems и быстрые исправления
Форматирование	документ, выделенный диапазон и отступ при вводе
Навигация	определения, ссылки, символы workspace и иерархия вызовов
Подсказки	описание при наведении, автодополнение, сигнатуры и inlay hints
Рефакторинг	переименование и быстрые действия

Рекомендуемые настройки

{
  "[bsl]": {
    "editor.defaultFormatter": "mussolene.1c-hbk-bsl",
    "editor.formatOnSave": true,
    "editor.formatOnType": true,
    "editor.tabSize": 4,
    "editor.insertSpaces": false
  }
}

Настройки расширения

Ключ	Назначение
onecHbkBsl.serverPath	Явный путь к onec-hbk-bsl; обычно оставьте значение по умолчанию
onecHbkBsl.indexDbPath	Пользовательский путь к SQLite-индексу
onecHbkBsl.indexMode	project, off, symbols или full
onecHbkBsl.indexMaxBytes	Максимальный размер индекса; -1 читает конфигурацию проекта
onecHbkBsl.logLevel	debug, info, warning или error
onecHbkBsl.diagnostics.enabled	Включает диагностики при наборе
onecHbkBsl.diagnostics.select	Оставляет только перечисленные правила
onecHbkBsl.diagnostics.ignore	Исключает перечисленные правила
onecHbkBsl.useDocker	Запускает LSP в уже работающем Docker-контейнере
onecHbkBsl.dockerContainer	Имя Docker-контейнера

Коды правил и совместимые псевдонимы перечислены в каталоге диагностик. Настройки анализа проекта лучше хранить в onec-hbk-bsl.toml, а настройки запуска сервера и редактора — в VS Code Settings.

После изменения пути к серверу или настроек диагностик выполните Developer: Reload Window.

Команды

Палитра команд содержит:

• 1C HBK BSL: Reindex Workspace;
• 1C HBK BSL: Reindex Current File;
• 1C HBK BSL: Show Index Status;
• 1C HBK BSL: Show Server Log.

Как выбирается сервер

Расширение проверяет источники в следующем порядке:

1. явный onecHbkBsl.serverPath;
2. бинарник, включённый в VSIX;
3. onec-hbk-bsl из PATH;
4. ранее загруженный бинарник в storage расширения;
5. подходящий бинарник из GitHub Release.

В обычной установке используется включённый в VSIX бинарник.

Устранение проблем

• Откройте 1C HBK BSL: Show Server Log.
• Проверьте, что workspace содержит .bsl или .os.
• Проверьте onec-hbk-bsl.toml, diagnostics.select и diagnostics.ignore.
• После крупных изменений выполните 1C HBK BSL: Reindex Workspace.
• Для собственного сервера укажите полный путь в onecHbkBsl.serverPath.