需将go安装路径（如/usr/local/go/bin）添加到path环境变量，并配置goroot指向go根目录；go 1.16+默认启用modules，无需gopath，但gopath/bin仍需加入path；构建必须在go.mod所在目录执行；goland需正确设置goroot、启用go modules、配置代理并重载项目。
go version 命令报 command not found 怎么办
说明系统根本没把 Go 的二进制文件加进 $PATH，终端压根找不到 go 这个命令。
macOS/Linux：打开终端，执行：echo $PATH 看输出里有没有 /usr/local/go/bin（或你实际安装路径的 /bin 子目录）
如果没有，就往 ~/.zshrc（macOS Catalina 及以后默认）或 ~/.bash_profile 末尾加一行：export PATH=$PATH:/usr/local/go/bin
然后运行 source ~/.zshrc
Windows：右键“此电脑”→属性→高级系统设置→环境变量→在“系统变量”里找到 Path→编辑→新增一行：C:\Program Files\Go\bin（路径以你安装位置为准，不是 C:\Program Files\Go）
改完必须新开一个终端窗口再试 go version，旧窗口不会自动加载新环境变量。
GOROOT 和 GOPATH 还用配吗
GOROOT 必须配，且必须指向 Go 安装根目录（比如 /usr/local/go），不是 /usr/local/go/bin；
GOPATH 在 Go 1.16+ 已基本退场，Go Modules 是默认模式，go mod init 后项目自己管理依赖，不再强制要求代码放 $GOPATH/src 下。
但注意：
- go install 安装的命令行工具（如 gopls）仍会放进 $GOPATH/bin，所以这个目录最好仍在 $PATH 里
- 如果你用的是老教程里“所有代码必须放在 $GOPATH/src”的写法，现在会直接失败——别照搬，直接在任意目录 go mod init myapp 就行
go run main.go 成功，但 go build 出来的程序一运行就 panic: failed to initialize module
这不是环境问题，是构建时没带模块上下文。典型触发场景：
- 在非模块根目录（即没有 go.mod 的目录）下执行 go build ./main.go
- 或用了 embed、runtime/debug.ReadBuildInfo() 这类依赖模块元信息的特性，但构建命令没走模块路径
正确做法：
- 确保在 go.mod 所在目录下执行构建命令
- 用 go build .（当前目录），而不是 go build main.go
- 如果要指定入口，用 go build ./cmd/myapp（前提是该子目录下有 main 包）
临时验证：进项目根目录后执行 go list -m，能打印出模块名才算模块上下文就绪。
GoLand 里右上角运行按钮灰色、import 标红
根本原因只有两个：GOROOT 没对齐，或 Go Modules 没启用。其他都是表象。
操作清单：
- Settings → Go → GOROOT → 点文件夹图标选到 /usr/local/go（macOS）或 C:\Program Files\Go（Windows），确认该路径下有 src、pkg、bin 三个文件夹
- Settings → Go → Go Modules → 勾选 “Enable Go modules integration”
- Proxy 输入框填完整：https://goproxy.cn,direct（缺 ,direct 会导致私有模块解析失败）
- 删掉项目根目录下的 go.work 文件（如果存在），它会强行启用多模块工作区，干扰单模块识别
- 右键项目根目录 → “Reload project”（不是 “Sync”）
做完必须重启 GoLand——GOROOT 修改只在重启后生效，IDE 的 GUI 进程不重载就不会读新配置。
最常被忽略的一点：GoLand 的 “Reload project” 和 “Sync” 是两回事，后者只刷新缓存，前者才真正触发 go list 和模块依赖解析。很多人卡在这一步反复折腾，其实只是点错了按钮。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
