Go go/types.Alias.Origin 怎样找到实例化别名的原始声明
在 Go 静态分析工具里,类型检查结果可能已经是一个带实参的别名,例如 Box[string]。如果只调用 String,你能看到实例化后的文字,却不一定能拿到泛型别名 Box[T] 的声明对象。解决办法是先把结果断言为 *types.Alias,再调用 Alias.Origin()。
官方文档地址:https://pkg.go.dev/go/types#Alias.Origin
Origin()返回创建当前实例的泛型Alias;如果当前对象不是泛型别名的实例,它就返回自身。要读取实例化实参,再调用TypeArgs();要读取声明对应的类型名,则使用Obj()。
先弄清 Alias、实例和 Origin 的关系
go/types.Alias 表示别名类型,普通声明类似 type ID = int。当别名带类型参数时,可以把它看成一张模板:泛型别名保存类型参数,实例化别名保存具体类型实参,而 Origin 把实例化对象指回这张模板。
这几个对象的职责可以这样区分:
| 调用 | 回答的问题 | 对实例化别名的意义 |
|---|---|---|
Origin() | 它来自哪个泛型 Alias? | 返回未带具体实参的原始泛型别名 |
TypeArgs() | 这次实例化用了什么实参? | 例如返回 string |
TypeParams() | 原始声明有哪些类型参数? | 例如返回 T |
Obj() | 声明的类型名对象是什么? | 实例与原始别名对应同一个声明名 |
Unalias() | 别名链最终指向哪个非别名类型? | 它解决的是底层类型问题,不是来源追踪问题 |

用 go/types 构造一个带类型参数的别名
为了聚焦 Origin 的语义,下面直接使用 go/types API 构造一个等价于 type Box[T any] = []T 的类型模型,再把它实例化为 Box[string]。这个写法适合说明类型对象之间如何连接,不依赖读取某个本地源码文件。
package main
import (
"fmt"
"go/token"
"go/types"
)
func main() {
pkg := types.NewPackage("example.com/demo", "demo")
aliasName := types.NewTypeName(token.NoPos, pkg, "Box", nil)
paramName := types.NewTypeName(token.NoPos, pkg, "T", nil)
// 用空接口作为约束,表示这个示例允许任意类型实参。
constraint := types.NewInterfaceType(nil, nil)
constraint.Complete()
t := types.NewTypeParam(paramName, constraint)
// origin 是泛型别名 Box[T] = []T,暂时还没有具体类型实参。
origin := types.NewAlias(aliasName, types.NewSlice(t))
origin.SetTypeParams([]*types.TypeParam{t})
// Instantiate 返回 Box[string] 的类型对象;校验参数数量和约束。
instantiated, err := types.Instantiate(nil, origin, []types.Type{types.Typ[types.String]}, true)
if err != nil {
// 类型实参不满足约束时,保留错误并停止读取后续元数据。
panic(err)
}
instance, ok := instantiated.(*types.Alias)
if !ok {
// 没有得到 Alias 时,当前结果就不能使用 Alias 专属方法。
panic("实例化结果不是 Alias")
}
fmt.Println("instance:", instance)
fmt.Println("origin:", instance.Origin())
fmt.Println("args:", instance.TypeArgs())
fmt.Println("object:", instance.Obj().Name())
}
关键点在于 Instantiate 的第二个参数仍然是 origin,所以返回结果保留了“这是某个泛型别名实例”的来源信息。把结果断言为 *types.Alias 后,才可以调用 Origin、TypeArgs 和 Obj。

通过 Origin 读取原始声明和实例实参
拿到实例后,最常用的读取顺序是:先保存 Origin(),再分别读取原始参数和当前实参。不要把 instance.Obj() 当成“实例独有的声明”;官方 API 对实例化类型的定义是,它与 origin 使用同一个类型名对象。
func describeAlias(instance *types.Alias) {
origin := instance.Origin()
// Origin 用来回到泛型声明,TypeParams 描述声明端的参数。
fmt.Println("origin:", origin.String())
fmt.Println("type params:", origin.TypeParams())
// TypeArgs 描述本次实例化传入的参数;普通非实例没有这些参数。
if args := instance.TypeArgs(); args != nil {
fmt.Println("type args:", args)
}
// Obj 是声明的 TypeName,用它取得包名、名称和声明位置。
obj := instance.Obj()
fmt.Println("declared name:", obj.Name())
fmt.Println("declared package:", obj.Pkg().Path())
}
如果你的工具要建立“实例 → 泛型声明”的索引,索引键可以来自 origin.Obj(),而实例专属信息单独保存 TypeArgs()。这样同一个 Box 可以对应多个不同实参,同时不会把它们误记成多个源声明。
普通别名为什么会得到自己
Origin 不会把所有别名都转换成另一种对象。对于没有实例化关系的普通别名,例如 type ID = int,调用 ID.Origin() 返回的就是 ID 自身。这个自返回行为让调用方可以统一处理“泛型别名实例”和“普通别名”,不必先猜测它属于哪一类。
func originOrSelf(alias *types.Alias) *types.Alias {
// Origin 对普通别名返回自身,因此这里可以统一返回声明来源。
if alias == nil {
return nil
}
return alias.Origin()
}
func underlyingType(alias *types.Alias) types.Type {
// Unalias 和 Origin 解决不同问题:这里明确要的是最终非别名类型。
return types.Unalias(alias)
}
注意,Origin 与 Unalias 不能互相替代:前者保留“由哪个泛型别名声明而来”的信息,后者沿别名链继续展开,目标是拿到第一个非别名类型。做代码导航、重构提示或泛型实例归并时优先用 Origin;做底层类型比较时再考虑 Unalias。
在类型分析器里落地时的四个检查点
- 先确认类型是
*types.Alias,不要对任意types.Type直接调用别名方法。 - 把
Origin()保存为来源对象,避免后续只依赖实例化后的String()。 - 用
TypeArgs()判断当前对象有没有具体实参,用TypeParams()描述泛型声明端。 - 只有确实需要底层类型时才调用
Unalias或Underlying,不要用它们代替来源索引。
归纳起来,Origin 解决的是“这个实例从哪一个泛型别名声明来”,TypeArgs 解决的是“这一次用了什么类型”,而 Obj 解决的是“声明名在哪里”。把三者分开保存,静态分析结果就能同时支持来源导航和实例参数展示。
Origin 会返回 nil 吗?
官方语义是返回原始泛型 Alias;当前对象不是泛型别名实例时返回自身。调用方仍应先确保接收者不是 nil。
Origin 和 Rhs 有什么区别?
Origin 返回泛型别名对象,Rhs 返回别名声明右侧的类型。一个用于找来源,一个用于查看别名指向的类型表达式。
TypeArgs 为什么可能是 nil?
非泛型别名或没有实例化实参的别名没有类型实参,因此 TypeArgs 可以是 nil。它不是错误信号,而是当前对象没有实例实参的表示。
Redis COMMAND LIST FILTERBY PATTERN 怎样按名称模式列出命令
- 上一篇
- Redis COMMAND LIST FILTERBY PATTERN 怎样按名称模式列出命令
- 下一篇
- LibreOffice Writer 怎样用状态栏切换插入和改写模式
-
- Golang · Go教程 | 16分钟前 |
- Go go/types.Array.Elem 怎样读取数组元素的类型
- 180浏览 收藏
-
- Golang · Go教程 | 31分钟前 | go · Go go/types.Var.SetKind Go VarKind go/types.Var
- Go go/types.Var.SetKind 怎样设置变量对象的种类信息
- 463浏览 收藏
-
- Golang · Go教程 | 39分钟前 | 标准库 · 常量 · 浮点数 · Go教程 · Go 浮点数 常量 go/constant float32 Float32Val
- Go go/constant.Float32Val 怎样判断常量能否精确表示为 float32
- 410浏览 收藏
-
- Golang · Go教程 | 46分钟前 | 标准库 · 常量 · Go教程 · Go Uint64 go/constant constant.Value MakeUint64 Uint64Val
- Go go/constant.MakeUint64 怎样创建保留无符号整数值的常量
- 431浏览 收藏
-
- Golang · Go教程 | 1小时前 | 标准库 · Go教程 · Go URL构造 go/doc/comment 文档链接 DocLink DefaultURL
- Go go/doc/comment.DocLink.DefaultURL 怎样把文档链接对象转换为默认URL
- 300浏览 收藏
-
- Golang · Go教程 | 1小时前 | go · Go 参数列表 go/ast token.Pos FieldList.Pos
- Go go/ast.FieldList.Pos 怎样确定参数列表的开始位置
- 393浏览 收藏
-
- Golang · Go教程 | 2小时前 | 标准库 · go · 源码分析 · Go go/token 源码位置 FileSet.Read
- Go go/token.FileSet.Read 怎样从自定义解码器恢复源码位置集合
- 265浏览 收藏
-
- Golang · Go教程 | 2小时前 | golang · 错误处理 · Go教程 · Go ErrorHandler go/scanner token.Position ErrorList.Add
- Go go/scanner.ErrorList.Add 怎样保留多个源码位置对应的扫描错误
- 459浏览 收藏
-
- Golang · Go教程 | 2小时前 | Go教程 · Go 文档注释 go/doc go/doc/comment Package.Parser
- Go go/doc.Package.Parser 怎样为包内注释配置链接解析器
- 257浏览 收藏
-
- 前端进阶之JavaScript设计模式
- 设计模式是开发人员在软件开发过程中面临一般问题时的解决方案,代表了最佳的实践。本课程的主打内容包括JS常见设计模式以及具体应用场景,打造一站式知识长龙服务,适合有JS基础的同学学习。
- 543次学习
-
- GO语言核心编程课程
- 本课程采用真实案例,全面具体可落地,从理论到实践,一步一步将GO核心编程技术、编程思想、底层实现融会贯通,使学习者贴近时代脉搏,做IT互联网时代的弄潮儿。
- 516次学习
-
- 简单聊聊mysql8与网络通信
- 如有问题加微信:Le-studyg;在课程中,我们将首先介绍MySQL8的新特性,包括性能优化、安全增强、新数据类型等,帮助学生快速熟悉MySQL8的最新功能。接着,我们将深入解析MySQL的网络通信机制,包括协议、连接管理、数据传输等,让
- 500次学习
-
- JavaScript正则表达式基础与实战
- 在任何一门编程语言中,正则表达式,都是一项重要的知识,它提供了高效的字符串匹配与捕获机制,可以极大的简化程序设计。
- 487次学习
-
- 从零制作响应式网站—Grid布局
- 本系列教程将展示从零制作一个假想的网络科技公司官网,分为导航,轮播,关于我们,成功案例,服务流程,团队介绍,数据部分,公司动态,底部信息等内容区块。网站整体采用CSSGrid布局,支持响应式,有流畅过渡和展现动画。
- 485次学习
-
- PubMedQA
- 深入了解PubMedQA生物医学问答数据集,涵盖其核心功能、使用方法及在临床决策、药物研发等场景的应用,助力提升NLP模型性能。
- 1093次使用
-
- H2O EvalGPT
- H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
- 1089次使用
-
- LMArena
- LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
- 1254次使用
-
- HELM
- 深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
- 1197次使用
-
- MMBench
- MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
- 1042次使用
-
- GOLANG使用Context管理关联goroutine的方法
- 2022-12-28 193浏览
-
- 聊聊Go中的注释和godoc工具
- 2022-12-29 354浏览
-
- 聊聊Golang语言中的复数类型
- 2023-01-07 418浏览
-
- 浅析Golang中的浮点类型(float32和float64)
- 2022-12-23 161浏览
-
- 聊聊Golang中的整数类型
- 2022-12-24 209浏览

