â java-lsp
Compréhension complÚte des projets Maven et Gradle grùce à Eclipse JDT.LS, le moteur Java de VS Code.
Ce plugin branche le serveur de langage Eclipse JDT Language Server sur votre agent IA. Au lieu de deviner la structure du code par recherche textuelle, l'agent interroge le serveur comme le ferait un IDE : résultats plus précis, plus rapides et moins coûteux en contexte.
âš Ce que votre agent sait faire avec ce plugin
| Capacité | Exemple de demande |
|---|---|
| đŻ Aller Ă la dĂ©finition | « OĂč est dĂ©fini ce symbole ? » |
| đ Trouver les rĂ©fĂ©rences | « Qui appelle cette fonction ? » |
| âïž Renommer un symbole | « Renomme cette classe dans tout le projet » |
| đ©ș Diagnostics | « Corrige les erreurs signalĂ©es dans ce fichier » |
| đŹ Survol (types, documentation) | « Quel est le type de cette variable ? » |
| đșïž Symboles du document et de l'espace de travail | « Liste les classes de ce module » |
Les capacités réellement disponibles dépendent de ce que le serveur implémente.
𧩠Compatibilité
| Agent | Fichier de configuration LSP | Format |
|---|---|---|
| GitHub Copilot CLI | com.github.copilot/lsp.json |
Agent Plugins 1.0 (plugin.json racine) |
| Claude Code | .lsp.json |
Plugin Claude Code (.claude-plugin/plugin.json) |
Les deux fichiers dĂ©crivent le mĂȘme serveur (jdtls). Ils existent en double car les deux agents n'utilisent pas les mĂȘmes noms de champs (fileExtensions pour Copilot, extensionToLanguage pour Claude).
đ PrĂ©requis
- JDK 21+ pour exécuter le serveur (vos projets peuvent cibler une version plus ancienne)
- Python 3 (le lanceur
jdtlsest un script Python)
âïž 1. Installer le serveur de langage
Le plugin ne contient que la configuration : le serveur doit ĂȘtre installĂ© sur votre machine et accessible dans le PATH.
macOS (Homebrew)
brew install jdtls
Linux / WSL
mkdir -p ~/.local/share/jdtls && \
curl -fsSL https://download.eclipse.org/jdtls/snapshots/jdt-language-server-latest.tar.gz \
| tar -xz -C ~/.local/share/jdtls && \
ln -sf ~/.local/share/jdtls/bin/jdtls ~/.local/bin/jdtls
đŠ 2. Installer le plugin
GitHub Copilot CLI
copilot plugin marketplace add SebastienDegodez/copilot-instructions
copilot plugin install java-lsp@copilot-instructions-sebastien-degodez
Ou directement, sans passer par la marketplace :
copilot plugin install SebastienDegodez/copilot-instructions:plugins/java-lsp
Claude Code
/plugin marketplace add SebastienDegodez/copilot-instructions
/plugin install java-lsp@copilot-instructions-sebastien-degodez
â 3. VĂ©rifier que tout fonctionne
Dans GitHub Copilot CLI :
/lsp list
/lsp test jdtls
Dans Claude Code : ouvrez une nouvelle session dans votre projet, puis demandez par exemple « Trouve toutes les références de maFonction ». En cas de souci, claude --debug affiche les journaux de démarrage du serveur.
đïž Fichiers pris en charge
| Extension | Identifiant de langage |
|---|---|
.java |
java |
â±ïž Ce serveur dĂ©marre lentement : le dĂ©lai est rĂ©glĂ© via
startupTimeout(Claude Code) etinitializationTimeoutMs(Copilot CLI).
đĄ Conseils
- Le premier dĂ©marrage importe le projet Maven/Gradle et peut ĂȘtre long : le dĂ©lai de dĂ©marrage est portĂ© Ă 2 minutes dans les deux configurations.
- Lancez
mvn compileougradle buildau moins une fois pour que les dépendances soient téléchargées. - Projet Lombok ? Ajoutez
"--jvm-arg=-javaagent:/chemin/vers/lombok.jar"dansargs.
đ ïž DĂ©pannage
| SymptĂŽme | Solution |
|---|---|
/lsp test jdtls échoue avec « command not found » |
Le binaire n'est pas dans le PATH : relancez l'étape 1 et ouvrez un nouveau terminal. |
| Délai de démarrage dépassé | Augmentez startupTimeout (Claude) ou initializationTimeoutMs (Copilot) sur les trÚs gros projets. |
Unsupported class file major version |
Le serveur tourne avec un JDK trop ancien : vérifiez que java -version renvoie 21 ou plus. |
Pour désactiver ce serveur dans un dépÎt précis (Copilot CLI), ajoutez dans .github/lsp.json :
{ "lspServers": { "jdtls": { "disabled": true } } }
đ Structure du plugin
java-lsp/
âââ plugin.json # Manifeste Agent Plugins 1.0 (Copilot CLI)
âââ .claude-plugin/
â âââ plugin.json # Manifeste Claude Code
âââ .lsp.json # Serveur LSP pour Claude Code
âââ com.github.copilot/
â âââ lsp.json # Serveur LSP pour Copilot CLI
âââ plugin.yaml # MĂ©tadonnĂ©es du site de documentation
âââ README.md
đ Liens utiles
Auteur : Sebastien DEGODEZ · Licence : Apache 2.0