Go go/ast.Field.Pos 怎样定位带名称和标签的字段起点
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 开始,标签从其字符串字面量的开引号开始。若有前置文档注释,注释也有独立的起点。选择哪一项取决于工具想提示哪一部分,不应把这些位置混为一谈。

用解析示例区分名称类型与标签
这段完整程序从内存源码解析结构体,分别打印字段、类型、标签和文档注释的位置。示例只读取 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 判断是否可用。

手工拼装 AST 时,若 Names 与 Type 都没有,方法会返回 NoPos。只有 Tag 并不能补出字段起点。另一个需要分开的情况是 nil 的 Field 指针:它与“有效指针但缺少位置”不同,调用前应由使用方处理。含 nil 标识符元素等不完整手工节点,也不应被当作解析器正常生成的节点使用。
把位置记录用于源码工具
采集阶段可以把字段声明起点与标签起点分别存储,显示诊断时再按提示内容选择。若以后改写源码,旧位置对应的是解析时那份内容,修改后应重新解析或采用明确的位置映射策略,不能只保留行号就假设永远正确。
Field.Pos 返回的是文件集位置编码。若要取得源码缓冲区中的字节偏移,应通过所属 token.File 的 Offset 转换,而不是把 token.Pos 强制转成整数当作切片下标。行列显示、字节偏移与节点起点是相关但不同的数据。
添加结构体标签会让 Field.Pos 指向标签吗?
不会。有名称时优先使用第一个名称的位置,标签应单独通过 Tag 定位。
Field 是否只代表结构体字段?
不是,它也用于接口方法、参数和结果等语法结构。本文示例限定遍历结构体字段,便于解释名称和标签。
前置注释算字段起点的一部分吗?
Field.Pos 不读取 Doc。若提示要包含文档注释,明确使用 Doc 的位置并处理其为空的情况。
Go encoding/base32.Encoding.EncodeToString 怎样直接生成 Base32 字符串
- 上一篇
- Go encoding/base32.Encoding.EncodeToString 怎样直接生成 Base32 字符串
- 下一篇
- Redis SCRIPT EXISTS 怎样批量判断脚本摘要是否已缓存
-
- Golang · Go教程 | 7分钟前 | Go教程 · Go go/constant constant.Value 复数常量 ToComplex
- Go go/constant.ToComplex 怎样把实数常量提升为复数常量
- 308浏览 收藏
-
- Golang · Go教程 | 18分钟前 | go · Go go/constant 字符串常量 MakeString
- Go go/constant.MakeString 怎样从运行时字符串构造字符串常量
- 175浏览 收藏
-
- Golang · Go教程 | 26分钟前 | go · Go main包 go/build Package.IsCommand
- Go go/build.Package.IsCommand 怎样判断构建包是不是 main 命令
- 107浏览 收藏
-
- Golang · Go教程 | 42分钟前 | go · Go break continue go/ast BranchStmt
- Go go/ast.BranchStmt 怎样读取 break 或 continue 的目标标签
- 157浏览 收藏
-
- Golang · Go教程 | 44分钟前 | 标准库 · go · Go 词法分析 go/token Token.IsLiteral
- Go go/token.Token.IsLiteral 怎样区分字面量记号与运算符
- 357浏览 收藏
-
- Golang · Go教程 | 1小时前 | 错误处理 · go · Go err go/scanner ErrorList error nil
- Go go/scanner.ErrorList.Err 怎样把空错误列表转换为 nil
- 171浏览 收藏
-
- Golang · Go教程 | 1小时前 | 标准库 · golang · Go 输出格式 go/doc 包文档 comment.Printer Package.Printer
- Go go/doc.Package.Printer 怎样定制包文档的输出格式
- 212浏览 收藏
-
- Golang · Go教程 | 1小时前 | go · Go 类型检查 go/types Package.GoVersion 语言版本
- Go go/types.Package.GoVersion 怎样读取类型检查记录的 Go 语言版本
- 176浏览 收藏
-
- Golang · Go教程 | 1小时前 | go · 泛型 · Go 泛型 类型约束 go/types TypeParam.Constraint
- Go go/types.TypeParam.Constraint 怎样取得泛型类型参数的约束类型
- 185浏览 收藏
-
- Golang · Go教程 | 1小时前 | Go教程 · Go 静态分析 ast go/types types.Info TypeAndValue IsType
- Go go/types.TypeAndValue.IsType 怎样判断表达式是否表示类型
- 235浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1095次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1092次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1256次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1197次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1046次使用
-
- Go map 并发写 panic 怎么办:从共享 map 到可控写入路径
- 2026-06-30 123浏览
-
- go语言中的defer关键字
- 2023-02-17 150浏览
-
- Golang中Interface接口的三个特性
- 2023-01-07 394浏览
-
- go语言中函数与方法介绍
- 2023-01-07 297浏览
-
- go语言数据类型之字符串string
- 2022-12-30 321浏览

