Go types.Package.Path 与 Name 为什么不能互相替代

types.Package.Path() 返回包路径，Name() 返回包声明名。不同路径可以采用同一个名称，因此包索引不能只按 Name 合并；导入语句里的本地别名又属于 types.PkgName，不能直接拿 Package.Name 代替。

官方文档：https://pkg.go.dev/go/types#Package；导入名称对象：https://pkg.go.dev/go/types#PkgName。

同名包覆盖的症状从哪里来

考虑一个假设的源码分析故障：依赖清单原本有两个 model 包，加入新依赖后页面却只剩一个，类型归属也跟着串到了另一条依赖上。先查看聚合键，如果代码使用 map[string]*types.Package 并以 pkg.Name() 写入，第二个同名包就会覆盖第一个。

这类问题的触发条件是“不同包采用同一个声明名”，不是编译器允许同一个文件无别名导入冲突名称。分析器处理的是跨文件、跨依赖的对象集合，不能用单个文件里的短名称规则去决定整个集合的身份。

用小示例拆开三个名称

以下原创示例直接构造元数据，不加载示例域名下的仓库，不调用导入器，也没有执行记录。它把包路径、声明名称与本地别名分别展示出来，便于定位错误字段。

package main

import (
 "fmt"
 "go/token"
 "go/types"
)

func main() {
 // 只构造包元数据，不联网加载这些示例路径。
 left := types.NewPackage("example.com/alpha/model", "model")
 right := types.NewPackage("example.com/beta/model", "model")
 byPath := make(map[string]*types.Package)
 for _, pkg := range []*types.Package{left, right} {
  byPath[pkg.Path()] = pkg
  fmt.Printf("path=%s name=%s\n", pkg.Path(), pkg.Name())
 }
 fmt.Println("路径索引条目数：", len(byPath))

 // PkgName 描述当前文件里的导入名称，不修改被导入包的声明名。
 owner := types.NewPackage("example.com/app", "app")
 local := types.NewPkgName(token.NoPos, owner, "domain", left)
 fmt.Printf("local=%s declared=%s imported=%s owner=%s\n",
  local.Name(), local.Imported().Name(),
  local.Imported().Path(), local.Pkg().Path())
}

示例中的 left 与 right 都叫 model，但包路径不同。local 的 Name 是 domain，Imported 返回 left，所以 Imported().Name 仍是 model。PkgName 的 Pkg 指向包含导入声明的 app 包；它与 Imported 的目标包不是同一个概念。

NewPackage(path, name) 接收调用方提供的两个值，并不会验证路径可下载，也不会按最后一段自动纠正声明名。实际分析中应使用加载或类型检查所得对象，不要把手工构造的占位对象当成已成功加载的完整包。

修复包索引与导入代码生成

修复故障时，先让聚合索引使用路径或加载器定义的包标识，再让展示层同时保留名称和路径。不要仅把界面上的 model 改成长字符串，却保留底层错误索引；覆盖已经发生时，展示层无法找回丢失对象。

代码生成则是另一个方向：选择器中需要当前文件可见的本地名称，而 import 引号中需要导入路径。同名冲突时应分配合法且不冲突的别名，并让生成的选择器一致使用它。点导入和空白导入也不能照搬成普通包限定符。

保留加载上下文避免再次合并

Path 比 Name 更适合区分包，却不意味着一个路径字符串足以作为永久的跨环境缓存键。同一路径可能在不同版本、构建标签、目标平台或测试变体下产生不同分析结果。缓存需要携带相应加载上下文；同一图中也应遵循加载器对包对象的一致管理。

因此，防复发的关键是明确字段职责：身份索引、界面标签、本地引用名称分别保存。对象指针的相等也只能在受控分析上下文中解释，不能跨独立加载轮次当成稳定标识。不要为了消除同名覆盖，反过来声称所有同路径对象都能任意合并。

常见问题：Name 必须等于路径最后一段吗？不能据此推断，应读取声明名。改导入别名会改变 Package.Name 吗？不会，别名属于本地导入对象。Path 是本机目录吗？不是，不要把包路径直接当作文件系统目录访问。只想输出友好名称可以用 Name 吗？可以，但在存在同名项时应附带路径帮助区分。