Поддержка Language Server Protocol (LSP)

Qwen Code предоставляет нативную поддержку Language Server Protocol (LSP), что позволяет использовать расширенные функции анализа кода, такие как переход к определению, поиск ссылок, диагностика и действия с кодом. Эта интеграция позволяет ИИ-агенту глубже понимать ваш код и оказывать более точную помощь.

Обзор

Поддержка LSP в Qwen Code работает за счёт подключения к языковым серверам, которые анализируют ваш код. После настройки серверов через .lsp.json (или расширения) Qwen Code может запускать их и использовать для:

• Перехода к определениям символов
• Поиска всех ссылок на символ
• Получения информации при наведении (документация, информация о типах)
• Просмотра диагностических сообщений (ошибки, предупреждения)
• Доступа к действиям с кодом (быстрые исправления, рефакторинг)
• Анализа иерархии вызовов

Быстрый старт

LSP является экспериментальной функцией в Qwen Code. Чтобы включить её, используйте флаг командной строки --experimental-lsp:

qwen --experimental-lsp

Запуск LSP-серверов управляется конфигурацией. Вы должны определить их в .lsp.json (или через расширения), чтобы Qwen Code мог их запустить.

Предварительные требования

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

Конфигурация

Файл .lsp.json

Вы можете настроить языковые серверы с помощью файла .lsp.json в корне проекта. В нём используется формат с ключами по языкам, описанный в справочнике по конфигурации LSP-плагинов Claude Code .

Базовый формат:

{
  "typescript": {
    "command": "typescript-language-server",
    "args": ["--stdio"],
    "extensionToLanguage": {
      ".ts": "typescript",
      ".tsx": "typescriptreact",
      ".js": "javascript",
      ".jsx": "javascriptreact"
    }
  }
}

Конфигурация C/C++ (clangd)

Зависимости:

• clangd (LLVM) должен быть установлен и доступен в PATH.
• Для получения точных результатов требуется база данных компиляции (compile_commands.json) или файл compile_flags.txt.

Пример:

{
  "cpp": {
    "command": "clangd",
    "args": [
      "--background-index",
      "--clang-tidy",
      "--header-insertion=iwyu",
      "--completion-style=detailed"
    ]
  }
}

Конфигурация Java (jdtls)

Зависимости:

• JDK установлен и доступен в PATH (java).
• JDTLS установлен и доступен в PATH (jdtls).

Пример:

{
  "java": {
    "command": "jdtls",
    "args": ["-configuration", ".jdtls-config", "-data", ".jdtls-workspace"]
  }
}

Параметры конфигурации

Обязательные поля

Необязательные поля

Транспорт TCP/Socket

Для серверов, использующих транспорт TCP или Unix-сокеты:

{
  "remote-lsp": {
    "transport": "tcp",
    "socket": {
      "host": "127.0.0.1",
      "port": 9999
    },
    "extensionToLanguage": {
      ".custom": "custom"
    }
  }
}

Доступные операции LSP

Qwen Code предоставляет функциональность LSP через унифицированный инструмент lsp. Ниже перечислены доступные операции:

Навигация по коду

Переход к определению (Go to Definition)

Находит место определения символа.

Operation: goToDefinition
Parameters:
  - filePath: Path to the file
  - line: Line number (1-based)
  - character: Column number (1-based)

Поиск ссылок (Find References)

Находит все ссылки на символ.

Operation: findReferences
Parameters:
  - filePath: Path to the file
  - line: Line number (1-based)
  - character: Column number (1-based)
  - includeDeclaration: Include the declaration itself (optional)

Переход к реализации (Go to Implementation)

Находит реализации интерфейса или абстрактного метода.

Operation: goToImplementation
Parameters:
  - filePath: Path to the file
  - line: Line number (1-based)
  - character: Column number (1-based)

Информация о символах

Наведение (Hover)

Получает документацию и информацию о типах для символа.

Operation: hover
Parameters:
  - filePath: Path to the file
  - line: Line number (1-based)
  - character: Column number (1-based)

Символы документа (Document Symbols)

Получает все символы в документе.

Operation: documentSymbol
Parameters:
  - filePath: Path to the file

Поиск символов в рабочей области (Workspace Symbol Search)

Ищет символы во всей рабочей области.

Operation: workspaceSymbol
Parameters:
  - query: Search query string
  - limit: Maximum results (optional)

Иерархия вызовов (Call Hierarchy)

Подготовка иерархии вызовов (Prepare Call Hierarchy)

Получает элемент иерархии вызовов в указанной позиции.

Operation: prepareCallHierarchy
Parameters:
  - filePath: Path to the file
  - line: Line number (1-based)
  - character: Column number (1-based)

Входящие вызовы (Incoming Calls)

Находит все функции, которые вызывают указанную функцию.

Operation: incomingCalls
Parameters:
  - callHierarchyItem: Item from prepareCallHierarchy

Исходящие вызовы (Outgoing Calls)

Находит все функции, которые вызываются указанной функцией.

Operation: outgoingCalls
Parameters:
  - callHierarchyItem: Item from prepareCallHierarchy

Диагностика

Диагностика файла (File Diagnostics)

Получает диагностические сообщения (ошибки, предупреждения) для файла.

Operation: diagnostics
Parameters:
  - filePath: Path to the file

Диагностика рабочей области (Workspace Diagnostics)

Получает все диагностические сообщения в рабочей области.

Operation: workspaceDiagnostics
Parameters:
  - limit: Maximum results (optional)

Действия с кодом (Code Actions)

Получение действий с кодом (Get Code Actions)

Получает доступные действия с кодом (быстрые исправления, рефакторинг) в указанном месте.

Operation: codeActions
Parameters:
  - filePath: Path to the file
  - line: Start line number (1-based)
  - character: Start column number (1-based)
  - endLine: End line number (optional, defaults to line)
  - endCharacter: End column (optional, defaults to character)
  - diagnostics: Diagnostics to get actions for (optional)
  - codeActionKinds: Filter by action kind (optional)

Типы действий с кодом:

• quickfix — Быстрые исправления ошибок/предупреждений
• refactor — Операции рефакторинга
• refactor.extract — Выделение в функцию/переменную
• refactor.inline — Встраивание функции/переменной
• source — Действия с исходным кодом
• source.organizeImports — Организация импортов
• source.fixAll — Исправление всех автоматически исправляемых проблем

Безопасность

По умолчанию LSP-серверы запускаются только в доверенных рабочих областях. Это связано с тем, что языковые серверы работают с правами вашего пользователя и могут выполнять код.

Управление доверием

• Доверенная рабочая область: LSP-серверы запускаются, если они настроены
• Недоверенная рабочая область: LSP-серверы не запустятся, если в конфигурации сервера не указано trustRequired: false

Чтобы пометить рабочую область как доверенную, используйте команду /trust или настройте доверенные папки в параметрах.

Переопределение доверия для отдельных серверов

Вы можете переопределить требования к доверию для конкретных серверов в их конфигурации:

{
  "safe-server": {
    "command": "safe-language-server",
    "args": ["--stdio"],
    "trustRequired": false,
    "extensionToLanguage": {
      ".safe": "safe"
    }
  }
}

Устранение неполадок

Сервер не запускается

1. Проверьте установку сервера: Запустите команду вручную для проверки
2. Проверьте PATH: Убедитесь, что бинарный файл сервера находится в системном PATH
3. Проверьте доверие к рабочей области: Для работы LSP рабочая область должна быть доверенной
4. Проверьте логи: Ищите сообщения об ошибках в выводе консоли
5. Проверьте флаг —experimental-lsp: Убедитесь, что вы используете этот флаг при запуске Qwen Code

Низкая производительность

1. Большие проекты: Рассмотрите возможность исключения node_modules и других крупных директорий
2. Таймаут сервера: Увеличьте startupTimeout в конфигурации сервера для медленных серверов

Нет результатов

1. Сервер не готов: Сервер может всё ещё индексировать файлы
2. Файл не сохранён: Сохраните файл, чтобы сервер обнаружил изменения
3. Неверный язык: Проверьте, запущен ли правильный сервер для вашего языка

Отладка

Включите логирование отладки, чтобы увидеть обмен данными LSP:

DEBUG=lsp* qwen --experimental-lsp

Или ознакомьтесь с руководством по отладке LSP в packages/cli/LSP_DEBUGGING_GUIDE.md.

Совместимость с Claude Code

Qwen Code поддерживает файлы конфигурации .lsp.json в стиле Claude Code с форматом ключей по языкам, определённым в справочнике по плагинам Claude Code . Если вы переходите с Claude Code, используйте в конфигурации макет с языком в качестве ключа.

Формат конфигурации

Рекомендуемый формат соответствует спецификации Claude Code:

{
  "go": {
    "command": "gopls",
    "args": ["serve"],
    "extensionToLanguage": {
      ".go": "go"
    }
  }
}

LSP-плагины Claude Code также могут предоставлять lspServers в plugin.json (или в связанном .lsp.json). Qwen Code загружает эти конфигурации при включении расширения, и они должны использовать тот же формат с ключами по языкам.

Рекомендации

1. Устанавливайте языковые серверы глобально: Это гарантирует их доступность во всех проектах
2. Используйте настройки для конкретного проекта: При необходимости настраивайте параметры сервера для каждого проекта через .lsp.json
3. Обновляйте серверы: Регулярно обновляйте языковые серверы для получения наилучших результатов
4. Доверяйте с умом: Помечайте как доверенные только рабочие области из надёжных источников

Часто задаваемые вопросы (FAQ)

В: Как включить LSP?

Используйте флаг --experimental-lsp при запуске Qwen Code:

qwen --experimental-lsp

В: Как узнать, какие языковые серверы запущены?

Используйте команду /lsp status, чтобы увидеть все настроенные и запущенные языковые серверы.

В: Можно ли использовать несколько языковых серверов для одного типа файлов?

Да, но для каждой операции будет использоваться только один. Побеждает первый сервер, который вернёт результаты.

В: Работает ли LSP в режиме песочницы?

LSP-серверы работают вне песочницы для доступа к вашему коду. На них распространяются элементы управления доверием к рабочей области.