Go TypeParam.Obj 怎样定位类型参数的源码声明

定位类型参数声明，可以从 tp.Obj() 取得声明 TypeName，再读取其 Pos，并用解析该源码时的 FileSet 转换成文件名、行和列。Obj 给出声明对象，Pos 是位置标记；单独打印 Pos 的整数不能直接当作编辑器行号。

官方文档：https://pkg.go.dev/go/types#TypeParam。

让类型对象保留声明入口

为源码导航工具接入泛型支持时，应保留检查所得的类型信息和原文件集。Signature 的 TypeParams 提供 TypeParam，Obj 关联 TypeName，后者带有声明名称与 Pos。这个结构让工具从类型对象回到声明，而不必在文本中搜索字母 T。

同一个文件里可能有多个函数各自声明 T。按名称搜索会碰到多个位置，按类型检查生成的声明对象访问，才能保留正确作用域关系。这里讨论函数自身声明的类型参数；接收者类型参数等场景要从对应列表取得对象。

用同一个 FileSet 解析位置

package main
import (
 "fmt"
 "go/ast"
 "go/parser"
 "go/token"
 "go/types"
)
func main() {
 // 解析与类型检查共享同一个文件集
 src := "package sample\nfunc Keep[T any](x T) T { return x }\n"
 fset := token.NewFileSet()
 file, err := parser.ParseFile(fset, "sample.go", src, 0)
 if err != nil { fmt.Println(err); return }
 conf := types.Config{}
 pkg, err := conf.Check("example.com/sample", fset, []*ast.File{file}, nil)
 if err != nil { fmt.Println(err); return }
 fn, ok := pkg.Scope().Lookup("Keep").(*types.Func)
 if !ok { fmt.Println("没有目标函数"); return }
 sig, ok := fn.Type().(*types.Signature)
 if !ok || sig.TypeParams().Len() == 0 { fmt.Println("没有类型参数"); return }
 tp := sig.TypeParams().At(0)
 // Obj 是声明 TypeName，Pos 仍需原文件集解释
 obj := tp.Obj()
 if !obj.Pos().IsValid() { fmt.Println("没有源码位置"); return }
 pos := fset.PositionFor(obj.Pos(), false)
 if !pos.IsValid() { fmt.Println("无法解释位置"); return }
 fmt.Printf("%s %s:%d:%d\n", obj.Name(), pos.Filename, pos.Line, pos.Column)
}

例子中的泛型函数位于 sample.go 第二行，类型参数 T 的声明标识符位于第11列。按源码内容与接口语义推导，导航应指向这个位置，而不是形参 x 使用 T 的位置。代码未在本机执行，不是实际运行记录。

示例不含 import，因此无需配置导入器。工程源码应复用已有的包加载流程，并把它持有的文件集传给导航逻辑。遇到解析或类型检查错误时，本例直接停止；不要静默把不完整信息输出成确定的跳转地址。

接入源码导航时处理位置边界

Pos 交给原 FileSet 解释后得到 Position，导航字段是 Filename、Line 与 Column。示例使用 PositionFor 的 false 参数，按物理源码位置解释；若希望尊重源码中的行位置指令，应明确选择调整后的显示位置，并让界面保持同一种规则。

Column 按字节计数，不能在含非ASCII字符的行中直接当成所有编辑器协议的字符偏移。若对接要求UTF-16位置的协议，需要结合原始行内容转换。位置结果也不保证磁盘文件仍然存在，源码快照和文件映射应由导航服务管理。

约束位置能从Obj.Pos得到吗？这里取得的是类型参数名字的声明位置。若要高亮完整约束表达式，应结合对应AST节点范围，不能把单个Pos当成整个声明区间。

能否缓存定位结果？可以按源码快照管理，但不要仅按类型参数名字缓存。跨文件、跨函数都可能重复使用T；缓存还要关联声明对象或稳定声明标识与版本。不要把一次位置转换描述成已测得的性能优化。

导航功能只需读取源码和类型元信息，无须执行被分析程序。对外日志可记录相对项目路径与失败原因，避免把机器私有绝对路径直接返回给不相关使用者。位置接口参考：https://pkg.go.dev/go/token#FileSet.PositionFor。