L'extension VS Code Go fournit une prise en charge linguistique riche pour le langage de programmation Go.
Visual Studio Code 1.75 ou version ultérieure (ou éditeurs compatibles avec les API VS Code 1.75+)
Passez à la version 1.21 ou plus récente.
Accueillir! ??
Que vous soyez nouveau sur Go ou un développeur Go expérimenté, nous espérons que cette extension répondra à vos besoins et améliorera votre expérience de développement.
Installez Go 1.21 ou une version plus récente si vous ne l'avez pas déjà fait.
Installez l'extension VS Code Go.
Ouvrez n'importe quel fichier Go ou go.mod pour activer automatiquement l'extension. La barre d'état Go apparaît dans le coin inférieur droit de la fenêtre et affiche votre version Go.
L'extension dépend de go
, gopls
(le serveur de langue Go) et d'outils optionnels en fonction de vos paramètres. Si gopls
est manquant, l'extension tentera de l'installer. Le signe ⚡ à côté de la version Go indique que le serveur de langue est en cours d'exécution et que vous êtes prêt à partir.
(Installer les outils manquants)
Vous êtes prêt à partir :-) ???
Explorez plus de fonctionnalités de l'extension VS Code Go.
Consultez la documentation sur les paramètres et les rubriques avancées pour personnaliser l'extension.
Consultez la documentation des outils pour obtenir une liste complète des outils dont dépend l'extension VS Code Go. Vous pouvez installer des outils supplémentaires et les mettre à jour en utilisant « Go : Installer/Mettre à jour les outils ».
Résolvez les problèmes avec les guides de dépannage général et de débogage.
déposer un problème pour des problèmes avec l'extension.
Démarrez une discussion GitHub ou obtenez de l'aide sur Stack Overflow.
Explorez les ressources linguistiques Go sur go.dev/learn et golang.org/help.
Si vous êtes nouveau sur Go, cet article donne un aperçu de l'organisation du code Go et des commandes go
de base. Regardez « Démarrer avec VS Code Go » pour une explication sur la façon de créer votre première application Go à l'aide de VS Code Go.
IntelliSense : les résultats s'affichent pour les symboles au fur et à mesure que vous tapez.
Navigation dans le code - Accédez ou jetez un coup d'œil à la déclaration d'un symbole.
Édition du code - Prise en charge des extraits enregistrés, du formatage et de l'organisation du code, ainsi que de l'organisation automatique des importations.
Diagnostics - Erreurs de construction, de vérification et de charpie affichées au fur et à mesure que vous tapez ou lors de l'enregistrement.
Prise en charge améliorée des tests et du débogage
Consultez la description complète des fonctionnalités pour plus de détails.
(Complétion de code et aide à la signature)
En plus des fonctionnalités d'édition intégrées, l'extension fournit plusieurs commandes pour travailler avec les fichiers Go. Vous pouvez accéder à n'importe lequel d'entre eux en ouvrant la palette de commandes ( Ctrl+Shift+P
sous Linux/Windows et Cmd+Shift+P
sous Mac), puis en tapant le nom de la commande. Consultez la liste complète des commandes fournies par cette extension.
(Basculer le fichier de test)
Pour une meilleure mise en évidence de la syntaxe, nous vous recommandons d'activer la mise en évidence sémantique en activant le paramètre ui.semanticTokens
de Gopls. "gopls": { "ui.semanticTokens": true }
L'extension VS Code Go prend en charge les modes de modules GOPATH
et Go.
Les modules Go sont utilisés pour gérer les dépendances dans les versions récentes de Go. Les modules remplacent l'approche basée sur GOPATH
pour spécifier quels fichiers sources sont utilisés dans une version donnée, et ils constituent le mode de construction par défaut dans go1.16+. Nous recommandons fortement le développement Go en mode module. Si vous travaillez sur des projets existants, envisagez de migrer vers des modules.
Contrairement au mode GOPATH
traditionnel, le mode module ne nécessite pas que l'espace de travail soit situé sous GOPATH
ni d'utiliser une structure spécifique. Un module est défini par une arborescence de répertoires de fichiers sources Go avec un fichier go.mod
dans le répertoire racine de l'arborescence.
Votre projet peut impliquer un ou plusieurs modules. Si vous travaillez avec plusieurs modules ou des présentations de projet inhabituelles, vous devrez configurer votre espace de travail à l'aide des dossiers d'espace de travail. Consultez la documentation sur les dispositions d'espace de travail prises en charge pour plus d'informations.
Si vous souhaitez bénéficier d'un accès anticipé aux nouvelles fonctionnalités et aux corrections de bugs, vous pouvez utiliser l'extension préliminaire. Conformément à la convention du vscode, nous utilisons la version mineure du numéro de version de l'extension pour distinguer les versions stables et préliminaires ( 0.ODD_NUMBER.patch
pour la pré-version, 0.EVEN_NUMBER.patch
pour la version stable).
Pour installer la version préliminaire, utilisez la liste déroulante pour sélectionner « Installer la version préliminaire », ou si l'extension Go est déjà installée, utilisez l'option « Passer à la version préliminaire » dans la gestion des extensions Visual Studio Code. page. Pour plus de détails sur ce mécanisme, consultez la documentation de Visual Studio Code.
L'extension VS Code Go s'appuie sur la télémétrie Go pour obtenir des informations sur les performances et la stabilité de l'extension et du serveur de langue ( gopls
). Le téléchargement des données Go Telemetry est désactivé par défaut et peut être activé avec la commande suivante :
go run golang.org/x/telemetry/cmd/gotelemetry@latest on
Une fois la télémétrie activée, le serveur de langue télécharge les métriques et empile les traces sur telemetry.go.dev. Vous pouvez vérifier quelles données sont collectées et peuvent être téléchargées en exécutant :
go run golang.org/x/telemetry/cmd/gotelemetry@latest view
Si nous obtenons suffisamment d’adoption, ces données peuvent accélérer considérablement le rythme de développement de l’extension Go et nous aider à atteindre un niveau de fiabilité plus élevé. Par exemple:
Même avec les rapports de crash semi-automatisés dans VS Code, nous avons vu plusieurs plantages ne pas être signalés pendant des semaines ou des mois.
Même avec une suite de benchmarks, certaines régressions de performances n'apparaissent pas dans notre environnement de benchmark (comme le bug de complétion mentionné ci-dessous !).
Même avec de nombreuses idées géniales sur la façon d’améliorer les gopls, nous disposons de ressources limitées. La télémétrie peut nous aider à identifier quelles nouvelles fonctionnalités sont les plus importantes et quelles fonctionnalités existantes ne sont pas utilisées ou ne fonctionnent pas bien.
Ce ne sont là que quelques façons dont la télémétrie peut améliorer les gopls. La série d’articles de blog sur la télémétrie en contient bien d’autres.
La télémétrie Go est conçue pour être transparente et préserver la confidentialité. Apprenez-en plus sur https://go.dev/doc/telemetry.
L'extension Go est gérée par les ingénieurs de l'équipe des outils Go, qui surveillent activement le VS Code Go et les outils de suivi des problèmes Go.
Nous prenons en charge uniquement les dernières versions stables et préliminaires de l'extension.
L'extension Go suit la politique de publication de Go, ce qui signifie qu'elle prend officiellement en charge les deux versions majeures de Go les plus récentes. L'équipe Go assure un support optimal pour les trois dernières versions majeures de Go.
L'extension Go s'appuie sur des outils tels que gopls
et dlv
pour ses fonctionnalités de base et ils ont leur propre politique et calendrier de publication. Nous testons uniquement sur les dernières versions de ces outils.
Si vous devez travailler avec une ancienne version de Go, veuillez consulter la page Compatibilité et installer manuellement la version compatible de l'extension et des outils.
Nous apprécions vos contributions et vous remercions d’avoir travaillé pour améliorer l’expérience de développement Go dans VS Code. Si vous souhaitez contribuer à travailler sur l'extension VS Code Go, consultez notre guide de contribution pour savoir comment créer et exécuter l'extension VS Code Go localement et contribuer au projet.
Ce projet suit le code de conduite de la communauté Go. Si vous rencontrez un problème lié à la conduite, veuillez envoyer un e-mail à [email protected].
MIT