当前位置:首页 > 文章列表 > Golang > Go教程 > Go go/ast.Field.Pos 怎样定位带名称和标签的字段起点

Go go/ast.Field.Pos 怎样定位带名称和标签的字段起点

来源:17golang原创 2026-11-18 15:45:02 0浏览 收藏

go/ast.Field.Pos() 在字段带名称时返回第一个名称的位置;没有名称而 Type 非空时返回类型表达式的位置;两者都没有时返回 token.NoPos。结构体标签 Tag 和文档注释 Doc 不参与这个起点选择,因此带标签的字段起点仍然通常落在字段名上。

官方地址:https://pkg.go.dev/go/ast

给源码工具选择标记位置时,应先问标记的对象是什么:整组字段声明、某一个字段名、类型、标签还是注释。下面按这个选择问题组织示例,不引入云部署,也不把演示写成亲历项目记录。

根据定位目标选择字段位置

定位目标可读取的位置前置条件
整组字段声明field.Pos()有效 Field 节点
某一个名称field.Names[i].Pos()索引有效且标识符非空
类型表达式field.Type.Pos()Type 非空
标签字面量field.Tag.Pos()Tag 非空
关联文档注释field.Doc.Pos()Doc 非空

例如 Display 字段带有 JSON 标签,字段声明本身从 Display 开始,类型从 string 开始,标签从其字符串字面量的开引号开始。若有前置文档注释,注释也有独立的起点。选择哪一项取决于工具想提示哪一部分,不应把这些位置混为一谈。

字段声明中名称、类型、标签与注释位置的静态关系
图1:字段位置结构说明图。每个组成部分拥有自己的位置,Field.Pos 的选择不由标签或注释决定。

用解析示例区分名称类型与标签

这段完整程序从内存源码解析结构体,分别打印字段、类型、标签和文档注释的位置。示例只读取 AST,不改写原始源码,也不执行被分析文件中的业务逻辑。

package main

import (
    "fmt"
    "go/ast"
    "go/parser"
    "go/token"
    "log"
)

func main() {
    // 标签使用双引号字面量,避免示例源码与外层原始字符串相互干扰。
    const src = `package sample
type Meta struct{}
type Record struct {
    // Display 是展示名称。
    Display string "json:\"display\""
    Left, Right int
    *Meta
}`
    fset := token.NewFileSet()
    tree, err := parser.ParseFile(fset, "record.go", src, parser.ParseComments)
    if err != nil {
        log.Fatal(err)
    }
    ast.Inspect(tree, func(n ast.Node) bool {
        st, ok := n.(*ast.StructType)
        if !ok {
            return true
        }
        for _, field := range st.Fields.List {
            // Field.Pos 是整组字段声明起点,不一定是类型起点。
            start := field.Pos()
            if !start.IsValid() {
                fmt.Println("字段起点不可用")
                continue
            }
            fmt.Printf("fieldStart=%s names=%d\n",
                fset.Position(start), len(field.Names))
            if field.Type != nil {
                fmt.Printf("typeStart=%s\n", fset.Position(field.Type.Pos()))
            }
            // Tag 与文档注释有自己的位置,均不替代字段起点。
            if field.Tag != nil {
                fmt.Printf("tagStart=%s\n", fset.Position(field.Tag.Pos()))
            }
            if field.Doc != nil {
                fmt.Printf("docStart=%s\n", fset.Position(field.Doc.Pos()))
            }
        }
        return true
    })
}

程序使用 parser.ParseComments 保留注释信息,方便比较 Doc 的位置。它只从 StructType.Fields.List 取得结构体字段,避免把函数参数等其他 Field 场景混进观察结果。位置由解析时的同一个 FileSet 转换为可读形式。

阅读打印字段时,fieldStart 是字段节点起点,typeStart、tagStart 和 docStart 是相应组成部分的起点。示例不预填运行日志;可以沿着源码内容判断每项记录对应哪个词法位置。

为嵌入字段和缺失位置保留分支

Left, Right int 在语法树中是一组字段声明,Names 保存两个标识符;Field.Pos 选择第一个,也就是 Left 的位置。如果任务只标记 Right,应定位对应的 Names 元素,不能仍用整个 Field 的起点。

对于嵌入字段 *Meta,Names 为空,Type 表示指针类型表达式,因此起点由 Type.Pos 提供,落在星号处。不要为了统一名称读取,直接访问 Names[0]。这里的 hasNames 与 hasType 可以作为工具自行记录的结构状态,最终的 token.Pos 则需要通过 IsValid 判断是否可用。

有名称、嵌入字段与缺失位置的结构条件
图2:起点选择条件说明图。名称和类型是两个独立条件,token.Pos 表示位置值;连线不是运行流程。

手工拼装 AST 时,若 Names 与 Type 都没有,方法会返回 NoPos。只有 Tag 并不能补出字段起点。另一个需要分开的情况是 nil 的 Field 指针:它与“有效指针但缺少位置”不同,调用前应由使用方处理。含 nil 标识符元素等不完整手工节点,也不应被当作解析器正常生成的节点使用。

把位置记录用于源码工具

采集阶段可以把字段声明起点与标签起点分别存储,显示诊断时再按提示内容选择。若以后改写源码,旧位置对应的是解析时那份内容,修改后应重新解析或采用明确的位置映射策略,不能只保留行号就假设永远正确。

Field.Pos 返回的是文件集位置编码。若要取得源码缓冲区中的字节偏移,应通过所属 token.File 的 Offset 转换,而不是把 token.Pos 强制转成整数当作切片下标。行列显示、字节偏移与节点起点是相关但不同的数据。

添加结构体标签会让 Field.Pos 指向标签吗?

不会。有名称时优先使用第一个名称的位置,标签应单独通过 Tag 定位。

Field 是否只代表结构体字段?

不是,它也用于接口方法、参数和结果等语法结构。本文示例限定遍历结构体字段,便于解释名称和标签。

前置注释算字段起点的一部分吗?

Field.Pos 不读取 Doc。若提示要包含文档注释,明确使用 Doc 的位置并处理其为空的情况。

参考资料:Go ast.Field 定义;Go 官方 ast.go 中 Field.Pos 实现。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Go encoding/base32.Encoding.EncodeToString 怎样直接生成 Base32 字符串Go encoding/base32.Encoding.EncodeToString 怎样直接生成 Base32 字符串
上一篇
Go encoding/base32.Encoding.EncodeToString 怎样直接生成 Base32 字符串
Redis SCRIPT EXISTS 怎样批量判断脚本摘要是否已缓存
下一篇
Redis SCRIPT EXISTS 怎样批量判断脚本摘要是否已缓存
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之JavaScript设计模式
    前端进阶之JavaScript设计模式
    设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
    543次学习
  • GO语言核心编程课程
    GO语言核心编程课程
    本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
    516次学习
  • 简单聊聊mysql8与网络通信
    简单聊聊mysql8与网络通信
    如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
    500次学习
  • JavaScript正则表达式基础与实战
    JavaScript正则表达式基础与实战
    在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
    487次学习
  • 从零制作响应式网站—Grid布局
    从零制作响应式网站—Grid布局
    本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
    485次学习
查看更多
AI推荐
  • PubMedQA数据集详解:生物医学问答基准、功能与应用指南
    PubMedQA
    深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
    1095次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1092次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1256次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1197次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1046次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码