包重命名语法为alias "path/to/package"，用于解决同名冲突或简化长路径；别名须为合法标识符且不与变量名重复，不支持在_或.导入中使用。
import 语句中包重命名的语法和常见写法
Go 允许在 import 时给包起别名，本质是为解决同名包冲突或简化长路径引用。语法就是 alias "path/to/package"，别名必须是合法标识符（不能含 /、.、- 等），且不能与当前文件中已声明的变量/函数名重复。
典型场景包括：
- 两个不同路径的包都叫
http（比如net/http和某个自定义http工具包），必须重命名其中一个 -
github.com/xxx/yyy/v2这类带版本后缀的路径太长，用v2简写更清晰 - 避免和本地变量名冲突：比如你有个变量叫
json，就不能直接import "encoding/json"，得写成jsonpkg "encoding/json"
重命名不会影响包内导出符号的访问方式
重命名只改变导入时的前缀，不改变包内部结构。比如你写了 http "net/http"，那后续调用仍是 http.Get(...)、http.NewRequest(...)，而不是 nethttp.Get(...) —— 后者根本不存在。
容易踩的坑：
立即学习“go语言免费学习笔记（深入）”；
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 误以为重命名能“合并”两个包：比如
a "pkg/a"和b "pkg/b"，它们的函数仍需分别用a.FuncA()、b.FuncB()调用，无法通过别名统一访问 - 把别名写成字符串字面量：
"http" "net/http"是错的，引号只包路径，别名在引号外 - 在
go mod tidy后忘记更新重命名后的引用，导致编译报undefined: http.Get（实际用了旧名）
模块路径变更时重命名不是解决方案
如果你改了 go.mod 中的 module 名（比如从 example.com/foo 改成 github.com/user/foo），所有 import 语句里的路径也必须同步改——此时靠重命名躲不开。重命名解决的是“多个包同名”，不是“路径失效”。
真实错误现象：
-
cannot find package "example.com/foo" in any of ...：说明 import 路径没随 module 名更新 - 即使你写了
foo "example.com/foo"，只要该路径下没对应代码，照样报错 - IDE 可能缓存旧路径，手动删掉
go.sum和vendor/（如果存在）再go mod tidy才能彻底刷新
匿名导入和点导入对重命名的影响
Go 支持两种特殊导入形式：_ "path"（匿名导入，只执行 init）和 . "path"（点导入，把包内导出符号直接注入当前命名空间）。这两种都不支持重命名——语法上就不允许加别名。
所以如果你看到类似 mysql _ "github.com/go-sql-driver/mysql"，这是非法的，会报 syntax error: unexpected _。正确写法只能是：
import (
_ "github.com/go-sql-driver/mysql"
"github.com/gin-gonic/gin"
)
点导入同样受限：. "fmt" 合法，但 fmtio . "fmt" 不合法。一旦用了点导入，就等于放弃包边界控制，容易引发符号冲突，生产环境慎用。
