GitLens и Error Lens для BSL в VS Code: настройки, сверенные с манифестами расширений

Три расширения делят между собой три задачи. BSL Language Server находит проблемы в коде. Error Lens выводит эти проблемы текстом справа от строки. GitLens показывает, кто и когда написал строку. Настройки в инструкциях по этой связке часто выдуманы по аналогии: некоторые имена, которые легко угадать, в манифестах расширений отсутствуют. Ниже собраны настройки, найденные в манифестах.

🧭 Что за что отвечает

BSL Language Server - анализатор кода на BSL. В VS Code его подключает расширение 1c-syntax.language-1c-bsl (по манифесту репозитория 1c-syntax/vsc-language-1c-bsl, версия 2.1.1). Сервер выдаёт диагностики: ошибки, предупреждения, замечания по стилю.

Error Lens (usernamehw.errorlens, версия 3.29.0 в репозитории) сам ничего не анализирует. Он берёт диагностики, которые уже видны редактору (те же, что в панели «Проблемы»), и рисует их в тексте. Для файлов .bsl диагностики приходят от языкового сервера, поэтому без него Error Lens покажет только то, что найдёт другой установленный анализатор.

GitLens (eamodio.gitlens, версия 19.2.0 в репозитории) показывает историю git внутри редактора. Синтаксиса BSL он не знает и знать не должен: git blame работает с любым текстовым файлом.

Версии выше взяты из package.json в основной ветке репозиториев на 30.09.2026. Версия в Marketplace может отличаться, минимальная версия VS Code указана в манифестах: ^1.101.0 у GitLens и ^1.107.0 у Error Lens.

🩺 BSL Language Server: когда появляются диагностики

Настройки языкового сервера лежат в файле .bsl-language-server.json в корне рабочей области. Расширение читает его по умолчанию: настройка language-1c-bsl.languageServerConfiguration содержит путь .bsl-language-server.json относительно каталога проекта.

Структура файла по документации BSL LS (значение computeTrigger изменено на onType):

1
2
3
4
5
6
7
8
9
10
11
12

{
  "$schema": "https://1c-syntax.github.io/bsl-language-server/configuration/schema.json",
  "diagnostics": {
    "computeTrigger": "onType",
    "parameters": {
      "LineLength": {
        "maxLineLength": 140
      },
      "MethodSize": false
    }
  }
}

Ключ computeTrigger определяет, когда сервер пересчитывает диагностики: onType (по мере ввода), onSave (при сохранении, значение по умолчанию) и never. Это главный практический вывод: с настройками по умолчанию Error Lens ничего не покажет, пока вы не сохраните файл. Хотите видеть ошибки при вводе, ставьте onType.

Параметры диагностики задаются объектом ("LineLength": {"maxLineLength": 140}), а отключается диагностика значением false ("MethodSize": false). Ключи диагностик из документации: LineLength, UnusedLocalVariable, EmptyCodeBlock, CommentedCode, UsingHardcodePath, CreateQueryInCycle, IdenticalExpressions, FunctionShouldHaveReturn, UnreachableCode, UsingHardcodeSecretInformation, ExecuteExternalCode. Полный список в документации BSL LS.

Если сервер завис, перезапуск делает команда расширения language-1c-bsl.languageServer.restart с заголовком «Restart the BSL Language Server» в палитре команд (Ctrl+Shift+P).

🔴 Error Lens: настройки, которые есть в манифесте

Ниже настройки, найденные в package.json Error Lens 3.29.0. Значения по умолчанию указаны из манифеста.

Названия, которые часто встречаются в инструкциях, но отсутствуют в манифесте 3.29.0: errorLens.fontStyle, errorLens.messageBackground, errorLens.gutterIcons. Вместо них действуют fontStyleItalic, messageBackgroundMode и gutterIconsEnabled. Расширение такие ключи не читает, поэтому подобная настройка ни на что не влияет.

Цвета сообщений задаются цветами темы, отдельных настроек с цветом у Error Lens нет. В манифесте объявлены errorLens.errorBackground, errorLens.errorForeground, errorLens.warningBackground, errorLens.warningForeground, errorLens.infoBackground и другие; переопределяются они через workbench.colorCustomizations:

1
2
3

"workbench.colorCustomizations": {
  "errorLens.errorBackground": "#ff000018"
}

Если один и тот же анализатор шумит замечаниями, их отсекает errorLens.excludeBySource. Чтобы узнать, какой источник и код у конкретной проблемы, наведите курсор на строку с диагностикой или откройте панель «Проблемы»: источник и код указаны там. Значения источника для BSL LS мы не проверяли.

👤 GitLens: настройки, которые есть в манифесте

Из манифеста GitLens 19.2.0:

Команды, которые есть в манифесте и вызываются из палитры команд (категория GitLens): Toggle File Blame (gitlens.toggleFileBlame), Toggle Line Blame (gitlens.toggleLineBlame), Toggle File Heatmap (gitlens.toggleFileHeatmap), Show File History View (gitlens.showFileHistoryView). Файловая аннотация blame и тепловая карта переключаются этими командами. Подпись текущей строки включена по умолчанию (gitlens.currentLine.enabled равна true).

Расширение бесплатное для перечисленных задач: по справке GitKraken текущая строка, аннотации blame и тепловой карты, подсказки, история файла и строки входят в бесплатный план. Граф коммитов на приватных репозиториях и Launchpad требуют платной подписки.

Версии взяты из package.json основных веток репозиториев на 30.09.2026; версия в Marketplace может отличаться. Это сверка манифестов, замеров в редакторе нет.

📚 Источники и чем эта статья отличается

Близкие темы на Infostart уже разбирали:

• «Как проверять код на языке 1С с помощью BSL Language Server»: зачем проверять код анализатором и как его запустить.
• «Современный инструментарий 1Сника»: обзор стека разработчика 1С: от EDT и Git до автотестов.

Здесь речь только о связке трёх расширений VS Code. Имена настроек сверены с манифестами GitLens 19.2.0 и Error Lens 3.29.0, разобрано, когда BSL Language Server выдаёт диагностики.

📦 Файл к статье

К публикации приложен архив 06.1-companion.zip, он в блоке «Файлы» вверху страницы:

• .vscode/settings.json - итоговые настройки из статьи: Error Lens показывает только ошибки и предупреждения BSL Language Server, GitLens - автора строки при наведении, порог «холодной» строки 180 дней, CodeLens выключен. Скопируйте папку .vscode в корень проекта или перенесите ключи в свой файл.
• proverka/manifest_dump.py - скрипт, которым имена настроек сверялись с манифестами расширений (package.json).
• proverka/manifest-*.txt - выгрузка настроек из манифестов GitLens 19.2.0, Error Lens 3.29.0 и расширения BSL 2.1.1 на 30.09.2026.
• README.md: что внутри, как пользоваться и что проверено.

📄 Итоговый settings.json

Все ключи ниже проверены по манифестам. Файл кладётся в .vscode/settings.json проекта:

1
2
3
4
5
6
7
8
9
10

{
  "errorLens.enabledDiagnosticLevels": ["error", "warning"],
  "errorLens.followCursor": "allLines",
  "errorLens.messageBackgroundMode": "message",
  "errorLens.fontStyleItalic": true,
  "gitlens.currentLine.enabled": true,
  "gitlens.hovers.currentLine.over": "line",
  "gitlens.heatmap.ageThreshold": 180,
  "gitlens.codeLens.enabled": false
}

Здесь оставлены только ошибки и предупреждения, чтобы в тексте было меньше шума, фон нарисован только под текстом сообщения, подсказка GitLens открывается при наведении на строку, порог «холодной» строки поднят до 180 дней, а CodeLens отключён, чтобы не сдвигать код вниз.

💡 Где связка полезна в проекте 1С

Разбор чужого модуля. Включите Toggle File Blame и посмотрите, какие блоки правили недавно и кто. Тепловая карта (Toggle File Heatmap) показывает давность изменений цветом.

Ревью. После сохранения файла Error Lens выведет замечания BSL LS прямо у изменённых строк, а подпись GitLens покажет, кто их автор и в каком коммите они появились.

Граница применимости: история строк есть только у текстовых файлов в git. Если вы храните конфигурацию как .cf или обработки как .epf (двоичные файлы), GitLens покажет историю файла, но не строк. Для построчной истории исходники нужно выгружать в XML или формат EDT.

🚧 Что не проверено

• Работа расширений в самом VS Code и Cursor: редактор не запускался, всё сверено с манифестами и документацией.
• Ключ источника у диагностик BSL LS для errorLens.excludeBySource.
• Языковой сервер BSL не запускался, список диагностик и параметры .bsl-language-server.json даны по документации.
• Cursor как форк VS Code: минимальная версия VS Code у расширений (^1.101.0, ^1.107.0) может не совпасть с версией ядра в вашей сборке Cursor.

🏁 Итог

Связка из трёх расширений работает, если помнить три вещи: Error Lens показывает только то, что нашёл анализатор, BSL LS по умолчанию считает диагностики при сохранении, а имена настроек нужно брать из манифестов. Расскажите в комментариях, какие диагностики BSL LS вы отключаете первыми.

 

Нинель Адольевна Щербакова (Ninel_S)

Архитектор • SRE & DevOps инженер • HighLoad 1С

Автор 28+ технических публикаций на Infostart. Разработчик NOPik, SRE-Suite-for-1C и мультиагентных ассистентов для экосистемы 1С:Предприятие.

Каталог статей и открытых репозиториев Ninel_S