ast.ParseFile 默认不保留注释，因注释非语法结构；需传 parser.ParseComments 标志启用，注释存于 *ast.File.Comments，须按位置手动匹配节点。
为什么 ast.ParseFile 默认不保留注释？
Go 的 AST 解析器默认会丢弃所有注释，因为注释不属于语法结构的一部分。如果你直接用 ast.ParseFile(fset, filename, src, 0)，得到的 *ast.File 里 Comments 字段永远是空的。必须显式启用注释收集，否则根本看不到任何注释节点。
关键点是第四个参数要传 parser.ParseComments，而不是 0 或其他 flag 组合。
-
parser.ParseComments是唯一能开启注释捕获的 flag - 它必须和
parser.Mode类型一起用，不能和go/ast的常量混用 - 如果用了
parser.AllErrors等其他 flag，记得用按位或组合：parser.ParseComments | parser.AllErrors
如何从 *ast.File 中提取注释？
启用 parser.ParseComments 后，注释不会“附着”在某个 AST 节点上，而是统一存放在 *ast.File.Comments 字段中，类型为 []*ast.CommentGroup。每个 *ast.CommentGroup 包含连续的行注释（//）或块注释（/* */），且已按源码位置排序。
注意：注释组本身不带位置语义（比如它属于哪个函数），需要你手动比对 CommentGroup.List[0].Pos() 和目标节点的位置范围（node.Pos() 到 node.End()）来判断归属。
立即学习“go语言免费学习笔记（深入）”；
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
-
CommentGroup.List是[]*ast.Comment，每个*ast.Comment的Text()返回带前缀的原始字符串（如"// hello"或"/* world */"） - 要去掉
//或/* */外壳，得自己做字符串裁剪，标准库不提供 clean 版本 - 单行注释若紧贴代码右侧（
fmt.Println("x") // inline），其位置落在语句末尾之后，需检查是否在语句End()前一小段范围内
怎么判断某段注释属于某个函数或字段？
AST 不自动绑定注释到节点，所以得靠位置匹配。最常用做法是：遍历 file.Comments，对每个 cg 取 cg.List[0].Pos()，再用 fset.Position() 转成行列信息，然后人工判断它是否出现在目标节点正上方（中间无空行）、或紧贴右侧。
更鲁棒的方式是检查注释起始位置是否落在节点“文档注释区间”内：即注释位置 ≥ 节点 Doc.Pos()（如果节点有 Doc 字段），或更实际地——检查它是否在节点之前、且距离足够近（比如同一列、上一行、且中间没其他非空行）。
- 函数声明的
*ast.FuncDecl.Doc字段，只在注释**严格位于函数声明正上方且无空行**时才被填充；否则为空，哪怕注释物理上很近 - 字段、变量等同理，
Field.Doc、ValueSpec.Doc都遵循同样规则 - 想捕获所有可能相关的注释（包括空行隔开的），就得绕过
.Doc，直接扫描file.Comments并做位置计算
常见错误：注释内容为空或乱码？
拿到 *ast.Comment.Text() 后发现是空字符串，大概率是因为你用了 token.FileSet 初始化方式不对。如果 fset 没通过 fset.AddFile(filename, fset.Base(), len(src)) 正确注册源码长度，Comment.Text() 就会返回空或越界截断。
另一个坑是：从文件读取源码时用了 os.ReadFile，但忘记把字节转成字符串再传给 parser.ParseFile —— 它第三个参数要求是 src interface{}，但实际期望是 string 或 []byte；传错类型可能导致解析静默失败或位置错乱。
- 务必确保
fset的 base offset 和源码长度一致，否则所有Pos()计算都不可靠 - 注释内容本身不含 BOM，但如果源码文件带 UTF-8 BOM，
Text()会原样包含，需自行 strip - 跨平台换行符（
\r\n）不影响Text()输出，但会影响你后续按行处理逻辑
注释位置匹配不是纯机械过程，尤其涉及空行、缩进、inline 注释时，边界情况多；别指望一次规则覆盖全部场景。
