包名冲突时为什么不能只改 import 路径
Go 的包名（package 声明）和 import 路径是两回事。即使你 import 了 "github.com/user/repo" 和 "golang.org/x/net/http2"，只要它们都声明了 package http2，在同一个文件里直接使用就会报 ./main.go:5:2: http2 is redeclared in this block —— 编译器认的是包名，不是路径。
常见错误现象：两个第三方库都导出同名类型（比如 Client、Config），不加处理就 import，编译失败或调用错对象。
- 必须用 import 别名显式区分，别名优先级高于原始包名
- 别名只在当前文件生效，不影响被导入包内部逻辑
- 别名不能是 Go 关键字（如
type、func），也不能和当前文件已声明的标识符冲突
import 别名的三种写法及适用场景
别名不是可选技巧，而是解决命名冲突的强制手段。不同写法对应不同意图：
-
http2 "golang.org/x/net/http2"：最常用。把整个包绑定到新标识符http2，后续所有调用都走http2.Do()这类形式 -
_ "github.com/mattn/go-sqlite3"：仅触发包初始化（init()），不引入任何符号。适合驱动注册类包 -
. "fmt"：把包内所有导出名“平铺”进当前命名空间。极度危险，仅限极简脚本或测试临时用，会掩盖本地变量、引发不可维护性
性能上无差异，但 . 导入会让 go vet 报 dot imports should not be used，CI 通常禁止。
立即学习“go语言免费学习笔记（深入）”；
多个同名包共存时的典型错误操作
新手常以为 “我只用其中一个的函数，另一个不用就行”，结果还是编译失败。因为 Go 不要求“显式调用才加载”，只要 import 了同名包，就构成冲突。
错误示例：
import (
"net/http"
"golang.org/x/net/http2" // ← 即使你没写 http2.ConfigureTransport，也报错
)
正确做法：
- 必须给至少一个包加别名，例如
http2x "golang.org/x/net/http2" - 如果两个包都来自同一作者的不同版本（如
v1和v2），别名建议带版本号，如httpv2 "github.com/xxx/lib/v2" - 别名不宜过短（如
h2），避免和业务变量名撞车；也不宜过长（如golang_org_x_net_http2），影响可读性
模块路径变更后别名要不要同步更新
不需要。import 别名和模块路径解耦——别名是你给它的“小名”，路径变只是“身份证地址”变了，小名照旧可用。
比如你原来写：grpc "google.golang.org/grpc"，后来模块升级到 google.golang.org/grpc/v2，只需改 import 路径：grpc "google.golang.org/grpc/v2"，别名 grpc 保持不变。
但要注意：
- v2 包可能导出结构体字段、方法签名有变化，别名掩盖不了 API 不兼容
- 如果旧版和新版同时 import，必须用不同别名（如
grpcv1/grpcv2），否则仍是包名冲突 -
go mod tidy不会自动帮你修别名，得自己核对
真正容易被忽略的是：别名解决了编译问题，但没解决语义混淆。比如 jsoniter "github.com/json-iterator/go" 和标准库 json 都有 Marshal，调用时得盯紧前面那个标识符——少个字母就跑偏到另一个实现里去了。
