--- title: Serveurs LSP description: OpenCode s'intègre à vos serveurs LSP. --- OpenCode s'intègre via le protocole LSP (Language Server Protocol) pour aider le LLM à interagir avec votre base de code. Il utilise des diagnostics pour fournir des commentaires au LLM. --- ## Serveurs intégrés OpenCode est livré avec plusieurs serveurs LSP intégrés pour les langages populaires : | Serveur LSP | Extensions | Prérequis | | ------------------ | ------------------------------------------------------------------- | ----------------------------------------------------------------------- | | astro | .astro | Installation automatique pour les projets Astro | | bash | .sh, .bash, .zsh, .ksh | Installe automatiquement le serveur bash-language-server | | clangd | .c, .cpp, .cc, .cxx, .c++, .h, .hpp, .hh, .hxx, .h++ | Installation automatique pour les projets C/C++ | | csharp | .cs | `.NET SDK` installé | | clojure-lsp | .clj, .cljs, .cljc, .edn | Commande `clojure-lsp` disponible | | dart | .dart | Commande `dart` disponible | | deno | .ts, .tsx, .js, .jsx, .mjs | Commande `deno` disponible (détection automatique deno.json/deno.jsonc) | | elixir-ls | .ex, .ex | Commande `elixir` disponible | | eslint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue | Dépendance `eslint` dans le projet | | fsharp | .fs, .fsi, .fsx, .fsscript | `.NET SDK` installé | | gleam | .gleam | Commande `gleam` disponible | | gopls | .go | Commande `go` disponible | | hls | .hs, .lhs | Commande `haskell-language-server-wrapper` disponible | | jdtls | .java | `Java SDK (version 21+)` installé | | julials | .jl | `julia` et `LanguageServer.jl` installés | | kotlin-ls | .kt, .kts | Installation automatique pour les projets Kotlin | | lua-ls | .lua | Installation automatique pour les projets Lua | | nixd | .nix | Commande `nixd` disponible | | ocaml-lsp | .ml, .mli | Commande `ocamllsp` disponible | | oxlint | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts, .vue, .astro, .svelte | Dépendance `oxlint` dans le projet | | php intelephense | .php | Installation automatique pour les projets PHP | | prisma | .prisma | Commande `prisma` disponible | | pyright | .py, .pyi | Dépendance `pyright` installée | | ruby-lsp (rubocop) | .rb, .rake, .gemspec, .ru | Commandes `ruby` et `gem` disponibles | | rust | .rs | Commande `rust-analyzer` disponible | | sourcekit-lsp | .swift, .objc, .objcpp | `swift` installé (`xcode` sur macOS) | | svelte | .svelte | Installation automatique pour les projets Svelte | | terraform | .tf, .tfvars | Installation automatique à partir des versions GitHub | | tinymist | .typ, .typc | Installation automatique à partir des versions GitHub | | typescript | .ts, .tsx, .js, .jsx, .mjs, .cjs, .mts, .cts | Dépendance `typescript` dans le projet | | vue | .vue | Installation automatique pour les projets Vue | | yaml-ls | .yaml, .yml | Installe automatiquement le serveur yaml-language-server de Red Hat | | zls | .zig, .zon | Commande `zig` disponible | Les serveurs LSP sont automatiquement activés lorsque l'une des extensions de fichier ci-dessus est détectée et que les exigences sont remplies. :::note Vous pouvez désactiver les téléchargements automatiques du serveur LSP en définissant la variable d'environnement `OPENCODE_DISABLE_LSP_DOWNLOAD` sur `true`. ::: --- ## Comment ça marche Lorsque opencode ouvre un fichier, il : 1. Vérifie l'extension du fichier par rapport à tous les serveurs LSP activés. 2. Démarre le serveur LSP approprié s'il n'est pas déjà en cours d'exécution. --- ## Configuration Vous pouvez personnaliser les serveurs LSP via la section `lsp` de votre configuration opencode. ```json title="opencode.json" { "$schema": "https://opencode.ai/config.json", "lsp": {} } ``` Chaque serveur LSP prend en charge les éléments suivants : | Propriété | Type | Description | | ---------------- | -------- | ---------------------------------------------------------------- | | `disabled` | booléen | Définissez ceci sur `true` pour désactiver le serveur LSP | | `command` | chaîne[] | La commande pour démarrer le serveur LSP | | `extensions` | chaîne[] | Extensions de fichiers que ce serveur LSP doit gérer | | `env` | objet | Variables d'environnement à définir lors du démarrage du serveur | | `initialization` | objet | Options d'initialisation à envoyer au serveur LSP | Regardons quelques exemples. --- ### Variables d'environnement Utilisez la propriété `env` pour définir les variables d'environnement lors du démarrage du serveur LSP : ```json title="opencode.json" {5-7} { "$schema": "https://opencode.ai/config.json", "lsp": { "rust": { "env": { "RUST_LOG": "debug" } } } } ``` --- ### Options d'initialisation Utilisez la propriété `initialization` pour transmettre les options d'initialisation au serveur LSP. Il s'agit de paramètres spécifiques au serveur envoyés lors de la requête LSP `initialize` : ```json title="opencode.json" {5-9} { "$schema": "https://opencode.ai/config.json", "lsp": { "typescript": { "initialization": { "preferences": { "importModuleSpecifierPreference": "relative" } } } } } ``` :::note Les options d'initialisation varient selon le serveur LSP. Consultez la documentation de votre serveur LSP pour connaître les options disponibles. ::: --- ### Désactivation des serveurs LSP Pour désactiver **tous** les serveurs LSP globalement, définissez `lsp` sur `false` : ```json title="opencode.json" {3} { "$schema": "https://opencode.ai/config.json", "lsp": false } ``` Pour désactiver un serveur LSP **spécifique**, définissez `disabled` sur `true` : ```json title="opencode.json" {5} { "$schema": "https://opencode.ai/config.json", "lsp": { "typescript": { "disabled": true } } } ``` --- ### Serveurs LSP personnalisés Vous pouvez ajouter des serveurs LSP personnalisés en spécifiant les extensions de commande et de fichier : ```json title="opencode.json" {4-7} { "$schema": "https://opencode.ai/config.json", "lsp": { "custom-lsp": { "command": ["custom-lsp-server", "--stdio"], "extensions": [".custom"] } } } ``` --- ## Informations supplémentaires ### PHP Intelephense PHP Intelephense offre des fonctionnalités premium via une clé de licence. Vous pouvez fournir une clé de licence en plaçant (uniquement) la clé dans un fichier texte à l'adresse : - macOS/Linux : `$HOME/intelephense/license.txt` - Windows : `%USERPROFILE%/intelephense/license.txt` Le fichier doit contenir uniquement la clé de licence sans contenu supplémentaire.