Les commentaires Golang se présentent sous deux formes : 1. Commentaires sur une seule ligne (appelés commentaires de ligne), avec la syntaxe "//commentaires sur une seule ligne" ; 2. Commentaires sur plusieurs lignes (appelés commentaires de bloc), commençant par avec "/*" et se terminant par "*/ " à la fin, et ne peut pas être imbriqué, la syntaxe est "/*Contenu du commentaire...*/". Les développeurs peuvent utiliser des commentaires sur une seule ligne commençant par "//" n'importe où, tandis que les commentaires sur plusieurs lignes sont généralement utilisés pour la documentation des packages ou pour commenter des extraits de code en blocs.
L'environnement d'exploitation de ce tutoriel : système Windows 7, GO version 1.18, ordinateur Dell G3.
Introduction aux commentaires
Le texte utilisé pour annoter et expliquer le programme est le commentaire. Améliore la lisibilité du code
Le rôle des commentaires dans le programme est d'annoter et d'expliquer le programme, en le rendant. plus facile de lire le code source. Le système de compilation ignorera automatiquement la partie commentée lors de la compilation du code source, donc les commentaires ne joueront aucun rôle dans la réalisation du fonctionnement du programme. L'ajout approprié de commentaires au code source peut améliorer la lisibilité du code source.
Les commentaires sont une bonne habitude de programmation qu'un programmeur doit avoir. Organisez d'abord vos pensées à travers des commentaires, puis utilisez du code pour les refléter.
Il existe deux formes de commentaires dans Golang
Les commentaires sur une seule ligne sont appelés commentaires sur une seule ligne. Ils constituent la forme de commentaires sur une seule ligne commençant par // et peuvent être utilisés n'importe où. ;
Les commentaires sur plusieurs lignes sont appelés commentaires de bloc, commençant par /* et se terminant par */, et ne peuvent pas être imbriqués. Les commentaires sur plusieurs lignes sont généralement utilisés pour les descriptions de documentation de packages ou les extraits de code commentés dans des blocs. [Recommandations associées : Tutoriel vidéo Go, Enseignement de la programmation]
1 Commentaires en ligne
Le format des commentaires sur une seule ligne est le suivant
//单行注释
Exemple :
2. Bloquer les commentaires (commentaires multi-lignes)
Le format des commentaires multi-lignes est le suivant
/* 第一行注释 第二行注释 ... */
Exemple :
3. Description
Chaque package doit avoir des commentaires pertinents, ajoutés avant d'utiliser le package. instruction pour déclarer le nom du package Les commentaires correspondants sont utilisés pour expliquer brièvement la fonction et le rôle du package.
Dans le même temps, le contenu du commentaire avant la déclaration du package sera considéré par défaut comme la documentation de ce package. Un package peut être réparti sur plusieurs fichiers, mais un seul d’entre eux doit être commenté.
Vous pouvez utiliser des lignes vides pour séparer plusieurs commentaires, comme indiqué ci-dessous :
// Package superman implements methods for saving the world. // // Experience has shown that a small number of procedures can prove // helpful when attempting to save the world. package superman
Il est préférable d'ajouter des commentaires correspondants aux variables, constantes, fonctions et autres objets dans le code, ce qui facilitera le développement ultérieur du code. Maintenance. , comme les commentaires sur la fonction enterOrbit dans le code suivant :
// enterOrbit causes Superman to fly into low Earth orbit, a position // that presents several possibilities for planet salvation. func enterOrbit() error { ... }
4. Détails d'utilisation
1) Pour les commentaires de ligne et les commentaires de bloc, le texte commenté ne sera pas exécuté par le compilateur Go.
2) Les commentaires de blocage ne peuvent pas être imbriqués dans les commentaires rapides.
Pour plus de connaissances sur la programmation, veuillez visiter : Vidéos de programmation ! !
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!