登录
推荐 文章 Go 技术 课程 下载 专题 AI
首页 >  Golang >  Go教程

Go go/types.Var.Origin 怎样取得实例化字段变量的原始对象

来源:17golang原创

时间:2026-11-18 16:17:39 461浏览 收藏

拿到实例化结构体中的 *types.Var 字段对象后,调用 field.Origin() 即可取得其规范原始变量对象。对于实例化过程中生成、依赖类型实参的字段,这个对象对应未实例化泛型声明中的字段;其他变量的 Origin 返回接收者自身。方法没有参数,返回类型仍是 *types.Var。

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

源码工具常需要同时回答两个问题:当前实例里的字段是什么类型,以及它来自哪处声明。前者保留实例字段对象,后者使用 Origin。把这两个对象分别记录,可以避免跳转到声明时丢掉当前实例的类型信息。

先确认手里拿到的是字段变量

types.Struct.Field(i) 返回字段变量对象。字段也属于 Var,所以这里调用的是 Var.Origin,而不是 Named.Origin。后者面对的是命名类型,不能用来直接替代字段对象的声明关联。

例如 Box[T] 声明字段 Item T,Box[int] 的 Item 在实例视角下具有 int 类型。把该实例字段称为 field,其原始对象称为 origin,即可分别读取 field.Type() 与 origin.Type()。名字 Item 本身不足以唯一定位声明,不同结构体可以使用同名字段。

实例字段与原始字段对象的静态关系
图1:字段来源结构说明图。实例字段保留替换后的类型,Origin 用于关联原始声明,两组对象承担不同用途。

解析泛型声明并取得实例字段

下面的完整程序使用标准库解析内存源码并做类型检查。被分析源码不导入外部包,因此示例无需配置导入器。Var.Origin 从 Go 1.19 提供,学习时应使用包含该方法的工具链。

package main

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

func main() {
    const src = `package sample
type Box[T any] struct { Item T }
var Current Box[int]
`
    fset := token.NewFileSet()
    tree, err := parser.ParseFile(fset, "box.go", src, 0)
    if err != nil {
        log.Fatal(err)
    }
    // Defs 用于记录声明对象,以便与 Origin 返回值关联。
    info := &types.Info{Defs: make(map[*ast.Ident]types.Object)}
    conf := types.Config{}
    pkg, err := conf.Check("sample", fset, []*ast.File{tree}, info)
    if err != nil {
        log.Fatal(err)
    }
    current, ok := pkg.Scope().Lookup("Current").(*types.Var)
    if !ok {
        log.Fatal("没有找到 Current 变量")
    }
    record, ok := current.Type().Underlying().(*types.Struct)
    if !ok || record.NumFields() == 0 {
        log.Fatal("Current 不是含字段的结构体类型")
    }
    field := record.Field(0)
    origin := field.Origin()
    // 当前字段的 Type 反映实例,原始对象用于关联声明。
    fmt.Printf("field=%s instanceType=%s originType=%s\n",
        field.Name(), field.Type(), origin.Type())

    for id, object := range info.Defs {
        if object == origin {
            fmt.Printf("declaration=%s position=%s\n",
                id.Name, fset.Position(id.Pos()))
        }
    }
}

示例先取得 Current 这个包变量,再从它的结构体底层类型取第一个字段。需要注意:目标是 record.Field(0) 得到的 Item,不是对 Current 本身调用 Origin 后就认为找到了 Item。

代码对解析、类型检查、对象类型断言和字段数量分别处理,再打印实例类型、原始类型与声明位置。这里没有预填运行日志;这些打印字段用于读者观察对象关系,并不表示本文运行了某个工程项目。

用 Origin 关联声明而保留实例类型

官方文档将规范原始变量与 Info.Defs 中记录的声明对象联系起来。示例在同一次类型检查中比较对象身份,找到原始字段对应的标识符。Info.Defs 是以标识符为键的映射,不应反向拿一个实例字段指针直接充当它的键。

工具可以把记录分成 instanceField、originField、instanceType 和 declaration 四项。前两项分别保存对象,第三项来自实例字段的 Type,最后一项记录声明位置。这些是工具自己的字段名,不是 go/types 自动生成的数据结构。

实例类型信息与声明索引的分组记录
图2:工具记录结构说明图。声明索引由原始对象关联,类型显示仍取实例对象,连线仅表达静态信息来源。

Origin 不会把 field 改回未实例化字段,也不会修改结构体。它提供原始对象供查询使用。若为了展示当前实例的字段类型而改读 origin.Type,就会重新看到声明中的泛型类型信息,这与“实例化没有生效”不是一回事。

整理工具中的对象比较规则

任务使用对象常见误区
显示当前字段类型实例字段 field改读原始对象后误判类型未替换
关联声明标识符field.Origin()只按字段名称全局搜索
取得结构体字段Struct.Field(i)把持有结构体的包变量当作字段

在同一次类型检查对象集合里,Origin 可作为声明归并的依据。不要把内存对象指针序列化成跨进程永久标识;多次独立检查产生的是不同的对象集合。需要持久化时,应额外设计包、声明和源码版本的标识,不能仅靠一个地址。

nil 变量指针也不应直接调用方法。示例中的安全性来自取得有效字段前的检查;面对手工拼装或不完整类型信息时,调用方仍要处理对象缺失。原始字段本身调用 Origin 返回自身是正常情况,并不说明 API 失效。

Origin 会返回 AST 字段节点吗?

不会,返回的是 go/types 的 Var。要关联语法节点,应借助本次类型检查记录的声明对象与 AST 标识符。

普通局部变量也能调用 Origin 吗?

可以;对于不属于相关实例化合成变量的对象,方法返回接收者自身。

两个字段名字一样就有同一个 Origin 吗?

不能这样推断。名字不是声明身份,应比较实际对象来源,并保留类型检查的上下文。

参考资料:Go Var.Origin 文档、Info 声明映射、Struct.Field。

声明:本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
相关阅读
更多>
最新阅读
更多>
课程推荐
更多>