不需要手动设置GOROOT和GOPATH；GOROOT通常由安装程序自动配置，GOPATH仅影响模块缓存位置（$GOPATH/pkg/mod），项目可任意路径初始化go mod init，无需强制放在$GOPATH/src下。
GOROOT 和 GOPATH 还要手动设吗？
不需要。Go 1.11 引入 Modules 后，GOROOT 仍指向 Go 安装目录（通常自动设置），但 GOPATH 已不再是“工作区根目录”的强制概念——它现在只影响 go mod download 缓存的默认位置（$GOPATH/pkg/mod），且可被 GOENV 或 go env -w GOPATH=... 覆盖。
新手常误以为必须把项目放在 $GOPATH/src 下才能编译，结果建好目录却 go run main.go 报错“cannot find package”。其实只要项目根目录含 go.mod 文件，Go 就按模块模式工作，路径完全自由。
- 推荐做法：直接在任意路径（如
~/projects/myapp）初始化模块：go mod init myapp - 避免陷阱：不要为兼容旧教程刻意创建
$GOPATH/src/github.com/username/project结构，除非你明确要发布到 GitHub 并复用老式 import path - 验证方式：运行
go env GOPATH看当前值，再执行go list -m，若输出模块名而非no modules supplied，说明模块已激活
项目目录里该放哪些子目录？
Go 没有官方强制约定，但社区通行结构直指可维护性。关键不是“标准”，而是让 go build 和 go test 能自然识别边界、避免循环导入。
-
cmd/：存放可执行文件入口，每个子目录一个main.go（如cmd/api,cmd/cli）。这是最无争议的分法，go build ./cmd/api直接产出二进制 -
internal/：放仅本项目使用的包。Go 编译器会阻止外部模块 importinternal/xxx，天然封装，比注释或命名约定更可靠 -
pkg/：若需被其他项目复用，且不属标准库范畴，才放这里。多数内部服务无需此层，过早抽象反而增加维护负担 - 避免常见错误：把所有 .go 文件平铺在项目根目录；或把 handler、service、model 全塞进
src/—— Go 不依赖目录名推断职责，而是靠包名和 import 路径
go mod vendor 之后目录怎么管？
go mod vendor 会把依赖复制到项目内的 vendor/ 目录，目的是锁定依赖、离线构建。但它不是“一劳永逸”，反而引入新管理成本。
立即学习“go语言免费学习笔记（深入）”；
- 必须同步更新：
go mod vendor不自动响应go.mod变更。每次go get或手动改go.mod后，需重新执行该命令，否则vendor/和模块声明脱节 - Git 提交策略：若启用 vendor，应把
vendor/加入 Git（否则 CI 构建失败）；但需在.gitignore中排除vendor/modules.txt（该文件由 Go 自动生成，不应手改） - 性能权衡：vendor 后构建变慢（需读取本地副本而非缓存），且
go list -m all显示的是 vendor 路径而非原始 module path，调试依赖问题时容易混淆 - 替代方案：CI 中直接用
GOFLAGS="-mod=readonly"强制校验go.mod一致性，省去 vendor 开销——只要网络可靠，这是更轻量的选择
Windows 用户特别注意的路径坑
Windows 的路径分隔符和空格用户名是 Go 工具链的隐形雷区，尤其影响 go build 和 go test 的文件定位。
- 绝对避免：
C:\Users\张三\go\src\myproject这类含中文或空格的路径。某些旧版go工具（如go tool cover）会因 shell 解析失败而报exec: "gcc": executable file not found（实际是路径截断） - 安全做法：将项目放在纯英文、无空格路径下，例如
C:\dev\myapp或D:\gocode\myapp；PowerShell 中用cd C:/dev/myapp（正斜杠兼容性更好） - 环境变量检查：运行
go env GOROOT GOPATH，确认输出路径不含中文、空格、括号；若GOPATH是默认值（如C:\Users\XXX\go），建议用go env -w GOPATH=C:\gopath显式重定向
go build 是否稳定、go test ./... 是否跑全、同事 clone 后能否 5 秒内上手改代码。那些看似“规范”的嵌套，一旦导致 import cycle not allowed 或 cannot find module providing package，就该立刻扁平化重构。 
