Maison  >  Article  >  développement back-end  >  Pourquoi les commentaires Doc pour les types Struct ne sont-ils pas détectés par l'analyseur Go ?

Pourquoi les commentaires Doc pour les types Struct ne sont-ils pas détectés par l'analyseur Go ?

Susan Sarandon
Susan Sarandonoriginal
2024-11-07 04:39:02605parcourir

Why are Doc Comments for Struct Types Not Detected by the Go Parser?

L'analyseur Go ne détecte pas les commentaires Doc sur le type de structure

La question est de savoir pourquoi les commentaires de documentation pour les types de structure ne sont pas détectés par le Allez aux packages analyseur et ast. L'exemple de code fourni utilise l'analyseur pour parcourir l'AST et imprimer la documentation pour les déclarations func, type et field. Cependant, la documentation pour les types struct n'est pas imprimée.

La réponse explique que la documentation pour les types struct est attachée au nœud GenDecl dans l'AST, pas au nœud TypeSpec. En effet, l'AST considère les définitions de type de structure individuelles comme des « contractions » de la version entre parenthèses des définitions de type. Le package go/doc gère ce cas en générant un faux nœud GenDecl et en le transmettant à la fonction readType s'il n'y a aucune documentation associée à la déclaration struct.

La réponse explique également pourquoi ce n'est pas la méthode préférée pour analyse les commentaires de la documentation et recommande d'utiliser le package go/doc à la place.

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!

Déclaration:
Le contenu de cet article est volontairement contribué par les internautes et les droits d'auteur appartiennent à l'auteur original. Ce site n'assume aucune responsabilité légale correspondante. Si vous trouvez un contenu suspecté de plagiat ou de contrefaçon, veuillez contacter admin@php.cn