Go语言环境能跑起来的关键是GOROOT、模块模式配置和工作目录结构三者对齐：GOROOT必须指向Go安装根目录（含src/pkg/bin），Go Modules启用后项目可置于任意路径并用go mod init初始化，目录结构应以go.mod为边界、cmd/放入口、internal/和pkg/分隔可见性。
Go 语言环境能跑起来，关键不在装了多少工具，而在于 GOROOT、GOPATH（或模块模式下是否绕过它）、工作目录结构这三件事是否对齐。多数人卡在“新建 main.go 点不了运行按钮”或“go run 报错找不到包”，本质是 IDE 或命令行没识别到模块根或没进对目录。
GOROOT 必须指向安装根目录，不是 bin 子目录
很多人把 GOROOT 配成 /usr/local/go/bin 或 C:\Go\bin，结果 IDE 里 import 全红、go 命令报 command not found。因为 Go 工具链依赖 src、pkg、bin 三个同级目录共存于根下。
- macOS：正确值是
/usr/local/go（Homebrew 安装）或$HOME/sdk/go（手动解压） - Windows：必须是
C:\Go，不能是C:\Go\bin - Linux：常见为
/usr/local/go或/opt/go，确认该路径下有src目录 - 验证方式：终端执行
go env GOROOT，输出应与你配置的一致；若为空或错误路径，说明环境变量没生效或 IDE 没读取到
Go Modules 启用后，GOPATH 不再决定项目位置
Go 1.11+ 默认启用模块（Modules），GOPATH 只影响 go install 输出的二进制位置，不再强制要求项目放在 $GOPATH/src 下。但很多人仍按老习惯把项目塞进 src，反而引发 go mod init 失败或版本解析混乱。
- 新建项目时，直接在任意空目录执行
go mod init example.com/myapp，模块路径不需对应磁盘路径 - IDE（如 GoLand）中若存在
go.work文件，会强制进入多模块工作区模式，单模块项目可能无法加载 —— 删除它再右键项目 → “Reload project” -
GOPATH仍建议设置（尤其要使用go install），但值可以是$HOME/go，且无需把项目放进去 - 代理必须带
direct：填https://goproxy.cn,direct，否则私有仓库或本地 replace 会失败
项目目录结构按用途分层，而非硬套 GOPATH 旧规
现代 Go 项目结构由模块名和子命令组织，不是靠 src/cmd/pkg 嵌套。常见错误是建一堆无意义的嵌套目录，导致 go run ./cmd/xxx 找不到入口或测试文件被构建约束屏蔽。
GoLand 2026.1.1 是 2026.1 发布后的首个维护修正版本，适合已经开始体验 2026.1 新功能并希望同步补丁的开发者。它更适合用于入门项目、现有项目迁移测试和 IDE 行为验证。
立即学习“go语言免费学习笔记（深入）”；
- 顶层放
go.mod，这是模块边界标志 - 命令入口统一放
cmd/下：如cmd/api/main.go、cmd/cli/main.go，便于用go run ./cmd/api运行 - 库代码放
internal/（仅本模块可用）或pkg/（可被外部引用），避免全放main包里 - 测试文件必须以
_test.go结尾，且函数签名是func TestXxx(*testing.T)，否则go test不识别 - 不要在项目根目录下放多个
main.go；一个模块一个入口点，多服务拆成多个cmd/xxx
GoLand 运行配置必须匹配当前文件意图
GoLand 右上角绿色三角灰掉，90% 是因为 Run Configuration 的 Working directory 或 Program arguments 没对准模块结构，不是代码写错了。
- 想运行当前文件（比如
cmd/api/main.go）：编辑 Run Configuration → Working directory 改为$FileDir$，Program arguments 留空 - 想运行整个命令目录：Working directory 保持项目根目录，Program arguments 填
./cmd/api - 如果用了
replace指向本地路径，确保被 replace 的路径是绝对路径，且该目录下有go.mod - 每次改完
go.mod或删了go.work，必须右键项目 → “Reload project”，不是点 “Sync”
最易被忽略的是：GoLand 启动时读取的是系统环境变量快照，改完 ~/.zshrc 或 Windows 环境变量后，必须重启 IDE 才生效；以及 go.work 文件的存在与否，会彻底切换模块解析逻辑，但它常被 Git 忽略，导致团队成员行为不一致。
