Go项目目录结构是否正确，取决于是否以go.mod所在目录为模块根、避免GOPATH/src嵌套、严格遵循internal访问规则、cmd按二进制分离、模块路径与仓库URL一致。
Go 环境搭得对不对，不看 go version 能不能跑通，而看目录结构是否让 go build、go run 和模块导入天然“懂你”——现代 Go 项目（Go 1.11+）根本不需要把代码塞进 $GOPATH/src，硬塞反而会触发模块冲突或路径解析异常。
go mod init 后的项目根目录就是模块根，别再建 src 子目录
很多人照着老教程，在 $HOME/go/src/myproject/ 下初始化项目，然后执行 go mod init myproject。结果发现 import "./internal/service" 报错，或 go run . 找不到包。问题不在代码，而在目录嵌套层级错了。
-
go mod init必须在项目**最外层目录**执行，该目录即为模块根，里面直接放go.mod、main.go、/cmd、/internal等子目录 - 若项目路径是
/Users/me/myapp，就 cd 进去再go mod init myapp；不是/Users/me/go/src/myapp - 旧式
GOPATH工作区（$GOPATH/src/xxx）与 Go Modules 共存时，Go 工具链会优先按模块路径解析，src目录纯属冗余，还可能干扰go list -m的模块识别
internal 目录不是可选装饰，而是编译期强制隔离机制
/internal 不是命名习惯，是 Go 编译器内置的访问控制规则：任何位于 internal/ 子目录下的包，**只能被其父目录或祖先目录中的包导入**。违反则报错 import "xxx/internal/util" is not allowed to import "xxx/internal/util"（实际错误信息更长，但核心是 “not allowed”）。
- 正确用法：
myapp/internal/handler可被myapp/cmd/server或myapp（模块根）导入，但不能被github.com/other/repo导入 - 路径必须含
/internal/字面量 ——/internals、/internalx、internal（无斜杠）均无效 - 如果误把
internal放在cmd/下（如cmd/server/internal），它只对cmd/server可见，无法被模块根或其他 cmd 共享，失去设计本意
cmd 目录下每个子目录对应一个独立可执行文件，别混在一起
/cmd 是存放主程序入口的约定位置，但它的价值在于“一个目录 = 一个二进制”，而不是收纳所有 main 函数的杂物间。常见错误是把多个服务写进同一个 cmd/main.go，靠 flag 切换行为，结果构建、部署、版本管理全乱套。
立即学习“go语言免费学习笔记（深入）”；
- 每个可执行目标应有独立子目录：
cmd/api、cmd/cli、cmd/migrate，各自含自己的main.go - 构建命令也按需分离：
go build -o bin/api ./cmd/api、go build -o bin/cli ./cmd/cli - 共享逻辑必须抽到
/internal或/pkg，禁止跨cmd/xxx直接 import —— 否则破坏单一职责，且cmd/api无法单独测试或替换依赖
go.work 用于多模块协作，不是替代 go.mod 的“高级模式”
当项目拆成多个模块（如 myapp/core、myapp/web、myapp/cli），有人试图用 go.work 统一管理，却忽略它只在**本地开发阶段有效**，CI 构建和生产部署仍以各模块自身的 go.mod 为准。
-
go work init应在工作区根目录执行，然后go work use ./core ./web—— 此时go run ./web才能感知core是本地修改版而非go.sum锁定版 -
go.work文件**不会被 go build 或容器镜像构建读取**，上线前务必验证各模块go.mod是否已replace掉临时路径，或已发布正式版本 - 若仅有一个模块，永远不需要
go.work；滥用它反而导致本地能跑、CI 失败、同事 clone 后go run报 missing module
真正容易被忽略的点是：模块路径（go mod init xxx 的参数）必须与代码仓库 URL 保持一致，哪怕只是本地 Git 仓库。比如 GitHub 仓库地址是 github.com/user/myapp，那模块名就必须是这个，否则 go get github.com/user/myapp 会拉错版本，第三方也无法正确 import 你的包。
