Prise en charge du Language Server Protocol (LSP)

Qwen Code propose une prise en charge native du Language Server Protocol (LSP), activant des fonctionnalités avancées d’intelligence du code telles que l’accès à la définition, la recherche de références, les diagnostics et les actions de code. Cette intégration permet à l’agent IA de mieux comprendre votre code et de fournir une assistance plus précise.

Présentation

La prise en charge du LSP dans Qwen Code fonctionne en se connectant à des serveurs de langage qui comprennent votre code. Une fois les serveurs configurés via .lsp.json (ou des extensions), Qwen Code peut les démarrer et les utiliser pour :

• Accéder aux définitions des symboles
• Trouver toutes les références à un symbole
• Obtenir des informations au survol (documentation, informations de type)
• Afficher les messages de diagnostic (erreurs, avertissements)
• Accéder aux actions de code (correctifs rapides, refactorisations)
• Analyser les hiérarchies d’appels

Démarrage rapide

Le LSP est une fonctionnalité expérimentale dans Qwen Code. Pour l’activer, utilisez l’indicateur de ligne de commande --experimental-lsp :

qwen --experimental-lsp

Les serveurs LSP sont pilotés par la configuration. Vous devez les définir dans .lsp.json (ou via des extensions) pour que Qwen Code puisse les démarrer.

Prérequis

Vous devez avoir installé le serveur de langage correspondant à votre langage de programmation :

Configuration

Fichier .lsp.json

Vous pouvez configurer les serveurs de langage à l’aide d’un fichier .lsp.json à la racine de votre projet. Ce fichier utilise le format utilisant le langage comme clé décrit dans la référence de configuration LSP pour les plugins Claude Code .

Format de base :

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

Configuration C/C++ (clangd)

Dépendances :

• clangd (LLVM) doit être installé et disponible dans le PATH.
• Une base de données de compilation (compile_commands.json) ou un fichier compile_flags.txt est requis pour obtenir des résultats précis.

Exemple :

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

Configuration Java (jdtls)

Dépendances :

• JDK installé et disponible dans le PATH (java).
• JDTLS installé et disponible dans le PATH (jdtls).

Exemple :

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

Options de configuration

Champs obligatoires

Champs facultatifs

Transport TCP/Socket

Pour les serveurs utilisant un transport TCP ou socket Unix :

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

Opérations LSP disponibles

Qwen Code expose les fonctionnalités LSP via l’outil unifié lsp. Voici les opérations disponibles :

Navigation dans le code

Accéder à la définition

Trouve où un symbole est défini.

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

Rechercher des références

Trouve toutes les références à un symbole.

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

Accéder à l’implémentation

Trouve les implémentations d’une interface ou d’une méthode abstraite.

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

Informations sur les symboles

Survol

Obtient la documentation et les informations de type pour un symbole.

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

Symboles du document

Obtient tous les symboles d’un document.

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

Recherche de symboles dans l’espace de travail

Recherche des symboles dans l’ensemble de l’espace de travail.

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

Hiérarchie d’appels

Préparer la hiérarchie d’appels

Obtient l’élément de hiérarchie d’appels à une position donnée.

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

Appels entrants

Trouve toutes les fonctions qui appellent la fonction donnée.

Operation: incomingCalls
Parameters:
  - callHierarchyItem: Item from prepareCallHierarchy

Appels sortants

Trouve toutes les fonctions appelées par la fonction donnée.

Operation: outgoingCalls
Parameters:
  - callHierarchyItem: Item from prepareCallHierarchy

Diagnostics

Diagnostics de fichier

Obtient les messages de diagnostic (erreurs, avertissements) pour un fichier.

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

Diagnostics de l’espace de travail

Obtient tous les messages de diagnostic dans l’espace de travail.

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

Actions de code

Obtenir les actions de code

Obtient les actions de code disponibles (correctifs rapides, refactorisations) à un emplacement donné.

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)

Types d’actions de code :

• quickfix - Correctifs rapides pour les erreurs/avertissements
• refactor - Opérations de refactoring
• refactor.extract - Extraire vers une fonction/variable
• refactor.inline - Intégrer (inline) une fonction/variable
• source - Actions sur le code source
• source.organizeImports - Organiser les imports
• source.fixAll - Corriger tous les problèmes corrigeables automatiquement

Sécurité

Par défaut, les serveurs LSP ne sont démarrés que dans les espaces de travail approuvés. En effet, les serveurs de langage s’exécutent avec vos permissions utilisateur et peuvent exécuter du code.

Contrôles d’approbation

• Espace de travail approuvé : Les serveurs LSP démarrent s’ils sont configurés
• Espace de travail non approuvé : Les serveurs LSP ne démarrent pas, sauf si trustRequired: false est défini dans la configuration du serveur

Pour marquer un espace de travail comme approuvé, utilisez la commande /trust ou configurez les dossiers approuvés dans les paramètres.

Remplacement de l’approbation par serveur

Vous pouvez remplacer les exigences d’approbation pour des serveurs spécifiques dans leur configuration :

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

Dépannage

Le serveur ne démarre pas

1. Vérifiez si le serveur est installé : Exécutez la commande manuellement pour vérifier
2. Vérifiez le PATH : Assurez-vous que le binaire du serveur se trouve dans le PATH de votre système
3. Vérifiez l’approbation de l’espace de travail : L’espace de travail doit être approuvé pour le LSP
4. Consultez les journaux : Recherchez les messages d’erreur dans la sortie de la console
5. Vérifiez l’indicateur —experimental-lsp : Assurez-vous d’utiliser cet indicateur au démarrage de Qwen Code

Performances lentes

1. Projets volumineux : Envisagez d’exclure node_modules et les autres répertoires volumineux
2. Délai d’expiration du serveur : Augmentez startupTimeout dans la configuration du serveur pour les serveurs lents

Aucun résultat

1. Serveur non prêt : Le serveur est peut-être encore en cours d’indexation
2. Fichier non enregistré : Enregistrez votre fichier pour que le serveur prenne en compte les modifications
3. Langage incorrect : Vérifiez si le serveur correct est en cours d’exécution pour votre langage

Débogage

Activez la journalisation de débogage pour voir la communication LSP :

DEBUG=lsp* qwen --experimental-lsp

Ou consultez le guide de débogage LSP dans packages/cli/LSP_DEBUGGING_GUIDE.md.

Compatibilité avec Claude Code

Qwen Code prend en charge les fichiers de configuration .lsp.json au style Claude Code, dans le format utilisant le langage comme clé défini dans la référence des plugins Claude Code . Si vous migrez depuis Claude Code, utilisez la disposition avec le langage comme clé dans votre configuration.

Format de configuration

Le format recommandé suit la spécification de Claude Code :

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

Les plugins LSP Claude Code peuvent également fournir lspServers dans plugin.json (ou un .lsp.json référencé). Qwen Code charge ces configurations lorsque l’extension est activée, et elles doivent utiliser le même format utilisant le langage comme clé.

Bonnes pratiques

1. Installez les serveurs de langage globalement : Cela garantit qu’ils sont disponibles dans tous les projets
2. Utilisez des paramètres spécifiques au projet : Configurez les options du serveur par projet si nécessaire via .lsp.json
3. Maintenez les serveurs à jour : Mettez régulièrement à jour vos serveurs de langage pour de meilleurs résultats
4. Accordez votre confiance avec discernement : N’approuvez que les espaces de travail provenant de sources fiables

FAQ

Q : Comment activer le LSP ?

Utilisez l’indicateur --experimental-lsp au démarrage de Qwen Code :

qwen --experimental-lsp

Q : Comment savoir quels serveurs de langage sont en cours d’exécution ?

Utilisez la commande /lsp status pour voir tous les serveurs de langage configurés et en cours d’exécution.

Q : Puis-je utiliser plusieurs serveurs de langage pour le même type de fichier ?

Oui, mais un seul sera utilisé pour chaque opération. Le premier serveur qui renvoie des résultats est retenu.

Q : Le LSP fonctionne-t-il en mode sandbox ?

Les serveurs LSP s’exécutent en dehors du sandbox pour accéder à votre code. Ils sont soumis aux contrôles d’approbation de l’espace de travail.