go 要求所有 import 路径必须使用完整、规范的模块路径（如 `github.com/user/hello/game-utils`），而非相对路径；通过严格遵循 `$gopath/src` 目录结构或启用 go modules，可实现本地开发与远程安装无缝兼容。
在 Go 语言中，不能使用 ./game-utils 这类相对路径进行包导入——这不仅违反 Go 工具链的设计原则，更会导致 go get、CI 构建、他人协作等场景下编译失败。根本原因在于：Go 编译器（go build、go test 等）始终基于 import path → 本地文件系统路径 的映射关系查找源码，而该映射严格依赖于 $GOPATH/src（Go 1.11+ 后推荐使用 Go Modules，但原理相通）。
✅ 正确做法：统一使用完整导入路径
假设你的 GitHub 仓库地址为 https://github.com/user/hello，那么所有子包都应按如下方式导入：
// hello/hello.go
package main
import (
"github.com/user/hello/games"
gameUtils "github.com/user/hello/game-utils" // 可带别名
)
func main() {
games.Play()
gameUtils.Validate()
}? 本地开发环境配置（Go 1.11 之前 / GOPATH 模式）
你需要将项目代码手动放置在符合 import path 的目录下：
# 假设 GOPATH=/home/user/go mkdir -p $GOPATH/src/github.com/user/hello cd $GOPATH/src/github.com/user/hello # 创建目录结构 mkdir games game-utils touch hello.go games/games.go game-utils/utils.go # 初始化 Git（可选，但推荐） git init git remote add origin https://github.com/user/hello.git
此时，go build 和 go test 会自动识别 github.com/user/hello/games 指向本地 $GOPATH/src/github.com/user/hello/games，无需任何路径替换。
? 推荐方案：使用 Go Modules（Go 1.11+ 默认启用）
现代 Go 开发强烈建议启用模块（Modules），它解耦了路径依赖与 $GOPATH，同时完全兼容远程导入：
# 在项目根目录（hello/）初始化模块 cd /path/to/hello go mod init github.com/user/hello # 自动生成 go.mod 文件： # module github.com/user/hello # go 1.21
之后，无论你在磁盘任意位置开发（如 ~/projects/hello），只要 go.mod 中声明了 module github.com/user/hello，所有 import "github.com/user/hello/..." 都会被正确解析为当前目录下的子包——无需 GOPATH，无需硬性目录匹配。
✅ 验证方式：
go list ./... # 应列出所有子包 go build # 成功编译 go get github.com/user/hello@latest # 其他人也能正常安装
⚠️ 注意事项
- ❌ 禁止在 import 中混用相对路径（如 "./games"）或 vendor 内部路径——Go 工具链会直接报错：local import "./games" in non-local package。
- ✅ 若使用 Go Modules，确保 GO111MODULE=on（1.16+ 默认开启），并避免在 $GOPATH/src 下重复初始化模块。
- ? 发布前请确保 GitHub 仓库名与 go.mod 中的 module 名完全一致（包括大小写），否则 go get 将无法定位。
- ? 提示：可借助 go mod edit -replace 临时重定向本地依赖（仅用于调试），但生产代码中仍应保持路径一致性。
遵循这一约定，你既能享受本地快速迭代的便利，又能保证 go get、Docker 构建、CI/CD 等流程零适配成本——这才是 Go “约定优于配置”哲学的真正实践。
