当前位置:首页 > 文章列表 > Golang > Go教程 > Go go/types.Alias.Origin 怎样找到实例化别名的原始声明

Go go/types.Alias.Origin 怎样找到实例化别名的原始声明

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

在 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()别名链最终指向哪个非别名类型?它解决的是底层类型问题,不是来源追踪问题
泛型别名 Alias T、实例化 Alias string 与 Origin 返回原始声明的静态关系图
图1:静态结构说明图。泛型 Alias、具体实例和 Origin 的指向关系用于解释来源追踪,不是运行截图或执行结果。

用 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。

Alias 实例的 Origin、TypeArgs、TypeParams、Obj 和 Rhs 元数据关系静态图
图2:静态元数据关系说明图。Origin 指向泛型声明,TypeArgs 保存实例实参,Obj 与 Rhs 分别对应声明名和右侧类型。

通过 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。

在类型分析器里落地时的四个检查点

  1. 先确认类型是 *types.Alias,不要对任意 types.Type 直接调用别名方法。
  2. 把 Origin() 保存为来源对象,避免后续只依赖实例化后的 String()。
  3. 用 TypeArgs() 判断当前对象有没有具体实参,用 TypeParams() 描述泛型声明端。
  4. 只有确实需要底层类型时才调用 Unalias 或 Underlying,不要用它们代替来源索引。

归纳起来,Origin 解决的是“这个实例从哪一个泛型别名声明来”,TypeArgs 解决的是“这一次用了什么类型”,而 Obj 解决的是“声明名在哪里”。把三者分开保存,静态分析结果就能同时支持来源导航和实例参数展示。

Origin 会返回 nil 吗?

官方语义是返回原始泛型 Alias;当前对象不是泛型别名实例时返回自身。调用方仍应先确保接收者不是 nil。

Origin 和 Rhs 有什么区别?

Origin 返回泛型别名对象,Rhs 返回别名声明右侧的类型。一个用于找来源,一个用于查看别名指向的类型表达式。

TypeArgs 为什么可能是 nil?

非泛型别名或没有实例化实参的别名没有类型实参,因此 TypeArgs 可以是 nil。它不是错误信号,而是当前对象没有实例实参的表示。

版本声明
本文转载于:17golang原创 如有侵犯,请联系study_golang@163.com删除
Redis COMMAND LIST FILTERBY PATTERN 怎样按名称模式列出命令Redis COMMAND LIST FILTERBY PATTERN 怎样按名称模式列出命令
上一篇
Redis COMMAND LIST FILTERBY PATTERN 怎样按名称模式列出命令
LibreOffice Writer 怎样用状态栏切换插入和改写模式
下一篇
LibreOffice Writer 怎样用状态栏切换插入和改写模式
查看更多
最新文章
查看更多
课程推荐
  • 前端进阶之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模型性能。
    1093次使用
  • H2O EvalGPT:开源LLM大模型评估与排行榜工具
    H2O EvalGPT
    H2O EvalGPT是H2O.ai推出的开源LLM评估平台,提供详细的大模型性能排行榜、行业特定基准测试及A/B测试功能,助您快速选择最适合项目的高性能大语言模型。
    1089次使用
  • LMArena是什么?伯克利AI模型评估平台使用指南与功能解析
    LMArena
    LMArena是加州大学伯克利分校推出的AI模型匿名评测平台。通过盲测投票机制,用户可对比不同大模型回答并生成实时排行榜,助力开发者优化模型及用户选择最佳AI工具。
    1254次使用
  • 斯坦福HELM:大语言模型Holistic Evaluation整体评估框架详解
    HELM
    深入了解斯坦福推出的HELM(Holistic Evaluation of Language Models)大模型评测体系。本文解析其核心功能、安装配置步骤及应用场景,涵盖准确性、公平性、鲁棒性等多维度指标,助力开发者全面优化语言模型性能。
    1197次使用
  • MMBench详解:多模态大模型基准测试、功能特点与使用指南
    MMBench
    MMBench是由上海人工智能实验室等机构联合推出的多模态基准测试平台,提供细粒度能力评估、大规模数据集及VLMEvalKit工具。本文详细介绍其核心功能、安装使用方法及应用场景,助力开发者全面评估多模态模型性能。
    1042次使用
微信登录更方便
  • 密码登录
  • 注册账号
登录即同意 用户协议 和 隐私政策
返回登录
  • 重置密码