Buf объявил 14 января 2026 года: LSP для protobuf проверяет схему

Что произошло с Protobuf и языковым сервером?

Поддержка появилась не внутри самого проекта Protobuf и не в Anthropic. Её выпустил Buf. Первоисточник: анонс Buf от 14 января 2026 года.

“Buf is proud to announce the first fully-featured, production-grade LSP server for Protobuf.”

Перевод: «Buf с гордостью представляет первый LSP-сервер для Protobuf с полным набором функций, готовый для production».

• Buf, анонс от четырнадцатого января.

До этого, по формулировке Buf, для Protobuf не было одного сопоставимого LSP-сервера с таким набором функций. Теперь Buf связывает сущности схемы между файлами и показывает диагностику прямо в редакторе. Я проверил список возможностей: из .proto можно перейти к определению, найти ссылки и получить автодополнение.

Перед генерацией кода ты получаешь ещё одну проверку схемы: редактор может показывать диагностику ошибок схемы раньше следующего запуска.

Версия Buf CLI или расширения в анонсе Buf не указана. Я не подставляю её из сторонних страниц: номер версии здесь остаётся неизвестным.

Что было раньше и что изменилось?

Я бы начал не с фразы production-grade, а со списка того, чего сервер пока не умеет. На старте он не добавляет import автоматически, не учитывает часть настроек buf.yaml, не подсказывает custom options и номера полей. Также нет отдельной поддержки Protovalidate, включая подсветку CEL-фрагментов.

Я нашёл ещё несколько расхождений в issue Buf: LSP не всегда следует buf.yaml, падает на некоторых .proto, а форматирование может отличаться от buf format; отдельный issue также посвящён отсутствию Format Selection. Поэтому «production-grade» не означает, что каждая команда редактора уже работает без сюрпризов.

Что проверить перед подключением Buf LSP?

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

Я разделяю две проверки:

1. Buf LSP проверяет и объясняет происходящее в редакторе.
2. Затем отдельно проверь проект инструментом, который используешь для генерации кода.

Поэтому после правки я всё равно запускаю обычную проверку схемы и кода.

С Claude Code, который читает файлы и может менять их как агент, граница ещё заметнее. Anthropic описывает работу с LSP через плагины. В Claude Code отдельно подключают LSP-плагин, а Buf LSP запускается через Buf CLI. Перед задачей проверь, какие файлы и настройки Claude Code реально видит, а не какие, как тебе кажется, должен видеть.

Проверь открытые `.proto`-файлы через доступный LSP.

Сначала перечисли:
- найденные диагностики;
- ошибки импортов;
- определения, к которым можно перейти;
- ссылки на определения;
- места, где требуется ручная проверка.

Не меняй файлы, не запускай генерацию и не переписывай связанные файлы автоматически: сначала собери список диагностик и мест для ручной проверки.
Если Buf LSP или его бинарник не подключён, прямо скажи об этом и остановись.

В официальном каталоге Anthropic Protobuf не указан среди готовых LSP-плагинов. Пользовательский плагин возможен, но для него отдельно нужен установленный бинарник сервера. Поэтому я бы не писал в задаче Claude Code «подключи Buf LSP» и не ждал, что агент сам найдёт рабочую интеграцию.

Как проверить подключение Buf LSP по шагам?

1. Установи расширение Buf в VS Code и открой файл с расширением .proto; отдельная команда установки в доступных материалах не приведена.

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

2. Подготовь Buf CLI для Neovim: он запускается как LSP-сервер.

   Минимальную версию CLI в доступных источниках определить нельзя. Я не добавляю команду установки или номер версии, потому что это пришлось бы брать из неподтверждённого документа.

3. Запусти сервер правильной командой. В настройке Neovim укажи запуск buf lsp serve.

   lua

   Скопировать

   vim.lsp.config('buf-lsp', {
       cmd = { 'buf', 'lsp', 'serve' },
       filetypes = { 'proto' },
       root_markers = { 'buf.yaml', '.git' },
   })

   Затем включи конфигурацию:

   lua

   Скопировать

   vim.lsp.enable('buf-lsp')

4. Укажи тип файлов proto. В конфигурации оставь filetypes = { 'proto' }.

   Я оставляю proto, чтобы Neovim запускал сервер только для .proto. Не подставляй сюда расширение .proto: в официальном примере Buf используется значение proto.

5. Выбери корень проекта. Для корня используй buf.yaml или .git.

   lua

   Скопировать

   root_markers = { 'buf.yaml', '.git' }

   Корнем я ставлю buf.yaml или .git: иначе импорт может проверяться не так, как в CLI. Если открыть отдельный файл не из того каталога, результат может отличаться от проверки Buf CLI.

6. Проверь работу на одном файле. Открой .proto и проверь диагностику, переход к определению и ссылки.

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

Сколько стоит Buf LSP и работает ли он из России?

Здесь важно разделить редактор и внешние сервисы. В VS Code в источнике указано расширение Buf. Neovim работает с локальным Buf CLI и командой buf lsp serve. Источники не сообщают о цене LSP или необходимости отдельного токена.

В проверенных источниках нет данных о:

• цене расширения;
• цене Buf CLI;
• наличии платных функций;
• региональных ограничениях;
• доступности загрузки из России;
• минимальной версии CLI.

Поэтому я не буду писать «Buf LSP бесплатен» или «из России всё работает». Таких данных в проверенных источниках нет. Перед подключением проверь официальную страницу расширения и документацию Buf на момент установки.

Вопросы и ответы