本文详解 go 项目正确目录结构、gopath 配置及跨包（如 constants → main）导入方案，解决因路径不规范导致的包不可见问题，并推荐符合 go 工具链习惯的工程组织方式。

本文详解 go 项目正确目录结构、gopath 配置及跨包（如 constants → main）导入方案，解决因路径不规范导致的包不可见问题，并推荐符合 go 工具链习惯的工程组织方式。

在 Go 中，包可见性与项目结构强相关——包名 ≠ 目录名，但 import 路径 = GOPATH/src 下的相对路径。你当前的目录结构本身合理（constants/ 和 main/ 作为独立包），但无法导入 constants 的根本原因在于：项目未置于 GOPATH/src 的合法子路径下。

✅ 正确配置 GOPATH（Go 1.11 前必需）

确保环境变量 GOPATH 指向一个包含 src/、bin/（可选）和 pkg/（自动生成）的目录，例如：

export GOPATH="$HOME/go"
# 对应路径结构：
# $GOPATH/src/Server-Client\ Game/     ← 你的项目根目录（必须在此之下！）
# $GOPATH/src/Server-Client\ Game/constants/server.go
# $GOPATH/src/Server-Client\ Game/main/main.go

此时，在 main/main.go 中即可通过 完整 import 路径 引用 constants 包：

package main

import (
    "fmt"
    "Server-Client Game/constants" // ← 关键：路径基于 $GOPATH/src
)

func main() {
    fmt.Println(constants.GameVersion) // 假设 constants/game.go 定义了该常量
}

⚠️ 注意：空格在 import 路径中是合法的（Go 支持 Unicode 路径），但强烈建议改用 server-client-game 这类无空格命名，避免 Shell 或 CI 工具兼容性问题。

? 推荐优化结构（现代 Go 实践）

尽管你的多级包结构可行，但更简洁、符合社区惯例的方式是将 main 包置于项目根目录（而非子文件夹），并统一管理依赖：

server-client-game/           # 项目根目录（位于 $GOPATH/src/ 下）
├── assets/
│   ├── css/
│   ├── js/
│   └── templates/
├── constants/                 # 独立包，导出常量/配置
│   ├── server.go
│   └── game.go
├── hub.go                     # 业务逻辑包（非 main）
├── player.go
├── main.go                    # package main，入口文件（在根目录！）
└── go.mod                     # Go 1.11+ 推荐：使用 Go Modules 替代 GOPATH（见下文）

此时 main.go 可直接导入：

import (
    "log"
    "server-client-game/constants" // 路径即模块名（或 GOPATH/src 下相对路径）
)

? 现代替代方案：Go Modules（推荐！）

若使用 Go 1.11+，优先启用 Go Modules，彻底摆脱 GOPATH 限制：

cd /path/to/server-client-game
go mod init server-client-game  # 生成 go.mod

此后 import "server-client-game/constants" 将被模块系统解析为本地路径（无需 GOPATH），且支持版本化依赖。执行 go build 或 go run main.go 即可自动解析本地包与远程依赖（如 github.com/gorilla/websocket）。

? 总结

• ❌ 错误做法：项目不在 $GOPATH/src/ 下，或 import 路径与 GOPATH 结构不匹配；
• ✅ 正确做法：
  • 方案一（传统）：将项目放入 $GOPATH/src/your-project/，按完整路径 import；
  • 方案二（推荐）：启用 Go Modules（go mod init），根目录放 main.go，用模块名 import；
• ? 始终确保 constants/ 包内有 package constants 声明，且导出标识符首字母大写（如 GamePort 而非 gamePort）。

遵循以上结构，即可无缝复用 constants 中的配置，同时保持项目可维护性与工具链兼容性。