Configuration du serveur LSP OpenCode

OpenCode s'intègre profondément au Language Server Protocol (LSP), en utilisant des serveurs LSP pour fournir aux LLM des retours en temps réel tels que des diagnostics de code et des indications d'erreur, aidant l'IA à comprendre et à manipuler votre base de code plus précisément.

En termes simples, un serveur LSP est un composant qui donne à OpenCode la capacité de « lire le code », semblable aux extensions de VS Code qui fournissent la complétion de code et des indications d'erreur. Lorsqu'une erreur de syntaxe ou une incompatibilité de type apparaît dans un fichier, le serveur LSP renvoie ces informations de diagnostic au LLM, lui permettant d'effectuer des modifications plus précises.

Comment ça marche

L'intégration LSP d'OpenCode est entièrement automatique et ne nécessite aucune intervention manuelle. Lorsqu'OpenCode ouvre un fichier, il exécute le processus suivant dans l'ordre :

打开文件
  │
  ▼
读取文件扩展名（如 .ts、.py、.go）
  │
  ▼
与所有已启用的 LSP 服务器进行匹配
  │
  ├── 匹配成功且服务器已运行 → 直接使用
  │
  └── 匹配成功但服务器未运行 → 自动启动对应 LSP 服务器

L'ensemble du processus s'exécute silencieusement en arrière-plan. Une fois le serveur LSP démarré, il fournit en continu des informations de diagnostic pour la session en cours.

Serveurs LSP intégrés

OpenCode dispose d'une prise en charge intégrée des serveurs LSP pour les langages courants,Lorsque l'extension de fichier correspondante est détectée et que les exigences pertinentes sont satisfaites, le serveur LSP est activé automatiquement, et dans la plupart des cas, aucune configuration n'est nécessaire.

Si vous ne souhaitez pas qu’OpenCode télécharge automatiquement les serveurs LSP, vous pouvez définir la variable d’environnementOPENCODE_DISABLE_LSP_DOWNLOADàtruepour désactiver le comportement de téléchargement automatique. Consultez les notes à la fin de cet article pour plus de détails.

Configuration des serveurs LSP

La configuration liée à LSP est écrite dans leopencode.jsondelspchamp. Dans la plupart des cas, aucune configuration n'est nécessaire et LSP sera activé automatiquement ; mais lorsqu'un comportement personnalisé est nécessaire, chaque serveur LSP prend en charge les éléments de configuration suivants :

1. Définition des variables d'environnement (env)

Utilisez laenvpropriété pour injecter des variables d'environnement au démarrage du serveur LSP. Couramment utilisée pour activer la journalisation de débogage ou spécifier les chemins requis par l'environnement d'exécution :

2. Définition des options d'initialisation (initialization)

initializationUtilisées pour transmettre une configuration spécifique au serveur LSP. Ces options sont envoyées une seule fois pendant le handshake LSP (initializerequest) phase et affectent tout comportement ultérieur du serveur :

Les options d'initialisation varient selon le serveur LSP. Par exemple,typescriptles options pourgoplssont complètement différentes ; consultez la documentation officielle du serveur LSP correspondant avant utilisation pour éviter de transmettre une configuration invalide.

Désactivation des serveurs LSP

1. Désactivation de tous les serveurs LSP

Si vous n'avez pas besoin du tout de la fonctionnalité LSP, vous pouvez définirlspentièrement àfalse, désactivant tous les serveurs LSP en même temps :

2. Désactivation d'un serveur LSP spécifique

Si vous souhaitez désactiver un seul serveur LSP tout en conservant les autres, définissez-le individuellement pour ce serveurdisabled: true：

Ajout de serveurs LSP personnalisés

Si le langage que vous utilisez ne figure pas dans la liste de prise en charge intégrée, vous pouvez spécifiercommandetextensionspour ajouter manuellement n'importe quel serveur LSP, à condition que le serveur respecte le protocole LSP standard et prenne en charge--stdiomode (communication via l'entrée/sortie standard) :

Vous pouvez également configurer des variables d'environnement et des options d'initialisation pour un serveur LSP personnalisé, exactement comme pour les serveurs intégrés :

Notes supplémentaires

Licence PHP Intelephense

PHP Intelephense propose une version gratuite et une version premium payante. La version premium est déverrouillée via une clé de licence et inclut des fonctionnalités améliorées telles que le tri des imports, le pliage du code, la visualisation de la hiérarchie des appels, etc. Si vous avez acheté une licence, écrivez simplement la clé dans un fichier texte au chemin suivant pour l'activer automatiquement, sans configuration supplémentaire :

Le fichier de licence doit contenir uniquement la clé de licence elle-même. N'ajoutez aucun autre contenu (y compris des espaces ou des sauts de ligne supplémentaires), sinon l'activation peut échouer.

Désactiver le téléchargement automatique

Par défaut, OpenCode télécharge automatiquement le serveur LSP requis depuis le réseau lorsqu'il détecte une extension de fichier correspondante. Si vous êtes dans un environnement à réseau restreint, ou si vous préférez gérer les outils LSP entièrement manuellement, vous pouvez désactiver les téléchargements automatiques en définissant la variable d'environnement suivante :

# Linux / macOS：临时禁用（仅当前终端会话有效）
export OPENCODE_DISABLE_LSP_DOWNLOAD=true

# Linux / macOS：永久禁用（写入 shell 配置文件）
echo 'export OPENCODE_DISABLE_LSP_DOWNLOAD=true' >> ~/.bashrc
source ~/.bashrc

# Windows（PowerShell：仅当前会话）
$env:OPENCODE_DISABLE_LSP_DOWNLOAD = "true"

Une fois désactivé, OpenCode ne téléchargera plus automatiquement aucun serveur LSP, mais les outils LSP déjà préinstallés sur le système peuvent toujours être détectés et utilisés normalement.