Développement de serveurs en langue GO (LSP)

LSP est un protocole standardisé utilisé pour connecter les éditeurs et les outils linguistiques pour implémenter des fonctions telles que la réalisation du code, la définition de saut, etc. 1. Il permet à l'éditeur de prendre en charge plusieurs langues une fois; 2. La logique est unifiée et facile à déboguer; 3. La chaîne d'outils native GO peut être utilisée. Pour développer des serveurs GO LSP, vous devez installer un environnement GO, introduire des packages GOPLS et LSP, créez la fonction principale pour démarrer le service et écouter la communication. MyServer doit implémenter des méthodes d'interface telles que l'initialisation, l'ouverture des fichiers et l'achèvement du traitement. Les fonctions de base incluent l'ouverture des fichiers, l'achèvement du code et la définition de saut. Les informations sur l'URI et l'emplacement doivent être analysées pendant les demandes et faites attention à la mise en cache, à la gestion des erreurs et aux problèmes d'accès simultané. Debug recommandait des journaux de sortie, simulez les demandes à l'aide de DLV ou de scripts pour assurer la synchronisation de l'état et la communication correcte.

La rédaction d'un serveur GO LSP (Protocole de serveur de langage) n'est pas particulièrement compliquée, mais il faut comprendre plusieurs points clés. Si vous avez effectué des extensions de développement de plug-in ou d'éditeur, il sera plus facile de commencer. L'idée principale du LSP est de découpler les éditeurs et les outils de langage, et GO n'est que l'une des langues à soutenir.

Qu'est-ce que le LSP et pourquoi est-il utilisé pour le support GO?

Le nom complet de LSP est le protocole de serveur linguistique. Il s'agit d'un protocole standardisé utilisé pour connecter les éditeurs (tels que VS Code, VIM) et les services linguistiques (tels que l'achèvement du code, la définition de saut, la vérification des erreurs). Pour GO, il dispose du serveur de langue officiel de GOPLS lui-même, mais si vous souhaitez personnaliser les fonctionnalités ou fournir une prise en charge améliorée pour un framework / bibliothèque spécifique, l'implémentation d'un serveur LSP vous-même sera utile.

Les avantages sont évidents:

• L'éditeur n'a besoin de se connecter qu'au protocole LSP une seule fois et peut prendre en charge plusieurs langues
• Logique unifiée, débogage facile
• Capable d'utiliser des chaînes d'outils natives Go (comme Go / Parser, Go / Types)

Préparation: dépendances et infrastructures

Pour commencer à développer le service LSP de Go, vous avez besoin:

• Installez l'environnement Go (recommandé 1.20)
• Introduire golang.org/x/tools/gopls et golang.org/x/tools/lsp packages connexes
• Créez une fonction principale pour démarrer le serveur et écouter STDIN / STDOUT ou socket

L'exemple de structure est à peu près la suivante:

 package principal

importer (
    "contexte"
    "enregistrer"

    "golang.org/x/tools/lsp/protocol"
)

func main () {
    serveur: = & myserver {}
    protocole.runserver (context.background (), serveur)
}

Tapez MyServer Struct {}

Ce MyServer doit implémenter certaines méthodes d'interface, telles que l'initialisation, l'ouverture des fichiers, le traitement des demandes d'achèvement, etc.

Implémentez les fonctions de base: de l'ouverture des fichiers à la réalisation du code

LSP est motivé par des événements et diverses demandes seront déclenchées lorsque les utilisateurs fonctionnent dans l'éditeur. Les fonctions les plus élémentaires comprennent:

• Ouverture de fichiers (textocument / didopen)
• Complétion du code (textocument / complete)
• Définition de saut (TextDocument / Définition)

Vous pouvez d'abord implémenter la méthode didOpen et imprimer le contenu de fichier ouvert pour voir si la communication est normale. Ajoutez ensuite d'autres fonctions étape par étape. Par exemple, dans la demande d'achèvement, vous pouvez appeler go/types pour la dérivation de type et analyser le contexte actuel en combinaison avec AST pour donner des invites plus intelligentes.

Quelques points à noter:

• Chaque demande contient un document URI et des informations de localisation. Le chemin doit être analysé correctement et le package GO correspondant est chargé.
• Il est important de gérer les caches, ne rechargez pas l'ensemble du projet à chaque fois
• La gestion des erreurs ne doit pas être manquante, surtout lorsque l'analyse échoue ou que le chemin n'existe pas.

Débogage et test: ne sautez pas cette étape

Le débogage d'un LSP est un peu comme le débogage d'un service réseau car il communique sur JSON-RPC. Vous pouvez utiliser la ligne de commande pour simuler les demandes ou utiliser le mode de débogage fourni avec gopls pour comparer le comportement.

Les questions fréquemment posées comprennent:

• Aucune information de configuration n'a été reçue pendant la phase d'initialisation
• Le chemin du document est incohérent et le fichier ne peut être trouvé
• L'accès simultané n'est pas traité, entraînant une confusion

Pratiques recommandées:

• Sortir chaque demande et retourner le journal
• Déboguez votre serveur avec dlv (Delve)
• Écrivez un petit script pour simuler l'éditeur et envoyer une demande LSP

Fondamentalement, c'est tout. Le développement du serveur LSP de Go n'est pas difficile, mais les détails sont faciles à coincés, surtout lorsque vous n'êtes pas familier avec la gestion des documents et la synchronisation de l'État. Cependant, une fois la première demande exécutée, la fonction d'addition suivante sera implémentée au besoin.

Ce qui précède est le contenu détaillé de. pour plus d'informations, suivez d'autres articles connexes sur le site Web de PHP en chinois!