包名冲突时必须用别名，不是可选项；go编译器只认package声明的名称，同名包导入即报错，唯一解法是显式加别名，如localutils "myproject/utils"和gorilla "github.com/gorilla/utils"。
包名冲突时必须用别名，不是可选项
Go 编译器只认 package 声明的名称，不看路径。两个不同路径的包只要都声明 package utils，在同一文件里直接导入就会报 utils redeclared in this block。这不是路径解析失败，也不是 IDE 显示问题，是编译期硬性限制。
常见错误操作包括：删掉一个包、改本地 package utils 为 package myutils、或者以为“我不调用它就没事”。这些都无效——只要 import 了同名包，冲突就成立。
- 唯一合法解法是显式加别名：
import localutils "myproject/utils"和import gorilla "github.com/gorilla/utils" - 别名必须写在双引号前，紧贴
import，不能有空格：import yaml "gopkg.in/yaml.v3"✅，import yaml" gopkg.in/yaml.v3"❌ - 别名不能是 Go 关键字（如
type、func），也不能和当前文件已声明的变量同名
别名要语义化，避免 u / v / x 这类缩写
短别名看着省事，但容易和业务变量撞车。比如 import u "github.com/xxx/utils"，之后又写 u := getUser()，立刻触发 u redeclared as imported package name。
更麻烦的是多人协作时，u.Do() 到底来自哪个 utils？没人能一眼分辨。
- 优先用来源缩写：
gh "github.com/google/go-github/v53/github"、gitlab "gitlab.com/gitlab-org/api/client-go" - 本地包建议带上下文：
local "myapp/internal/utils"，而不是l "myapp/internal/utils" - 版本差异明显时，别名可含版本信息：
grpcv2 "google.golang.org/grpc/v2"
别名和局部变量同名会遮蔽包引用
这是运行时逻辑错误，不是编译错误。代码能跑，但行为不对。
典型场景：导入 tasks "code.google.com/p/google-api-go-client/tasks/v1"，然后在循环里写 tasks, _ := api.Tasks.List().Do()。此时 tasks 变量会遮蔽 tasks 包，后续再写 tasks.NewClient() 就报 undefined: tasks.NewClient。
- 解决方法不是改变量名，而是改包别名：
tsk "code.google.com/p/google-api-go-client/tasks/v1" - 别名一旦确定，所有调用点必须同步更新：
tsk.NewClient()，不能漏掉任何一处 - 重构时用
grep -r "tasks\." ./扫描调用点，IDE 的重命名功能不一定覆盖跨文件引用
别名不影响构建，但影响符号跳转准确率
go mod tidy 完全不管别名，它只管依赖树和 go.sum。别名改不改、怎么改，都不会触发模块校验失败。
但 IDE（尤其是老版本 GoLand）对过短或无上下文的别名解析不准。比如 h "net/http"，跳转可能失败或指向错误位置。
- 别名作用域仅限当前文件，其他文件可以起不同别名，互不影响
- 模块路径变更（如从
v1升级到v2）时，别名可保持不变，只需更新引号内路径：grpc "google.golang.org/grpc/v2" - 真正容易被忽略的是：别名不解决 API 不兼容问题。v2 包里
Client.Do()签名变了，别名再好也掩盖不了这个事实
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
