GoLand不自动添加包别名，必须手动声明；同名包冲突时需显式重命名以避免编译错误，别名仅在当前文件生效且不影响init执行与符号可见性。
GoLand不自动加别名，得手动写
GoLand 本身不会在自动导入时帮你加包别名——它只按路径生成 import "xxx" 语句。别名是开发者的显式决策，IDE 不会猜测你是否需要 v2 "github.com/example/pkg/v2" 还是 http "net/http"。所以“配置自动导入别名”这个需求本身不成立，正确做法是：先让 GoLand 正常导入包，再根据冲突或可读性需要，手动补上别名。
同名包冲突时必须手动加别名，否则编译失败
当你同时用到两个同名包（比如 "net/http" 和自定义的 "company/internal/http"），Go 编译器直接报错：import "company/internal/http" conflicts with import "net/http"。这时必须在 import 块里显式重命名其中一个：
- 别名必须是合法标识符：不能是
http_v2这种带下划线的？不，http_v2是合法的；但2http或http-legacy就非法 - 别名不能和当前文件已声明的变量/函数名重复：比如你写了
var http *Client，就不能再用http "net/http" - 别名只在当前文件生效：其他文件要同样冲突，也得各自加别名，不存在“全局别名配置”
GoLand 能帮你检查别名使用是否一致
一旦你手动加了别名（如 jsonpkg "encoding/json"），GoLand 会在你后续调用时自动补全 jsonpkg.Marshal()，而不是提示 json.Marshal()。但它不会主动提醒你“这里该用别名”，也不会在 go mod tidy 后自动修复旧引用。容易踩的坑包括：
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 改了别名但忘了更新所有调用点 → 编译报
undefined: json.Marshal（实际你已改成jsonpkg） - 在多个文件中用了不同别名指向同一包（如
json1 "encoding/json"和json2 "encoding/json"）→ 可读性差，且跨文件传递类型时可能混淆 - 误把别名当包路径用：写成
import jsonpkg "encoding/json"; func f() jsonpkg.RawMessage是对的，但写成func f() encoding/json.RawMessage会语法错误
真正要配的是 Go Modules 和 goimports
别名本身不需要 IDE 配置，但想让别名后的代码干净、无冗余、能自动整理，必须确保两件事：
立即学习“go语言免费学习笔记（深入）”；
- Settings → Go → Go Modules 中勾选
Enable Go Modules integration，否则 GoLand 根本不识别go.mod，所有包路径解析都错位 - Settings → Tools → Actions on Save → 勾选
Optimize imports，前提是系统 PATH 里有goimports（运行go install golang.org/x/tools/cmd/goimports@latest安装） -
goimports会自动删掉未用的 import 行，但不会动你写的别名——它只管“有没有用”，不管“叫什么名”
别名不是语法糖，是解决冲突的刚需。写的时候多敲几个字母，换来的是编译通过和逻辑清晰；指望 IDE 自动生成，反而容易漏掉真正关键的命名决策点。
