最常见原因是PATH未正确包含$GOROOT/bin或$GOBIN；Windows需关闭旧终端重开，Linux/macOS需检查shell配置文件并source生效，IDE内置终端常不继承环境变量。
go version 不生效，终端找不到 go 命令
最常见原因是 PATH 没正确包含 $GOROOT/bin 或 $GOBIN。Windows 安装 .msi 包虽自动写入 PATH，但旧 CMD/PowerShell 窗口不会自动刷新环境变量——必须关掉所有终端再重开。
- Linux/macOS：检查
~/.zshrc或~/.bash_profile是否有export PATH=$PATH:/usr/local/go/bin（或你自定义的$GOROOT/bin） - macOS 若用 zsh，改完后务必执行
source ~/.zshrc；用 bash 则对应source ~/.bash_profile - Windows 用户可直接在 CMD 中运行
echo %PATH%，确认输出里含C:\Go\bin或你安装路径下的\bin - 别依赖 IDE 内置终端“自动继承环境”——VS Code、GoLand 有时会读取系统快照而非实时 PATH，建议先在系统终端验证
go version成功，再开 IDE
go mod init 后依赖拉不下来，报 timeout 或 “no matching versions”
国内网络环境下，默认 GOPROXY=direct 会让 go get 直连 proxy.golang.org，99% 失败。这不是代码问题，是代理没设对。
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（七牛云镜像，稳定）或https://mirrors.aliyun.com/goproxy/ - 顺手加上
go env -w GOSUMDB=sum.golang.org，避免校验失败；若公司私有模块，还需go env -w GOPRIVATE=git.example.com/* - 验证是否生效：
go env GOPROXY应输出你刚设的地址，不是direct或空值 - 已有
go.mod但拉错包？删掉go.sum和vendor/（如有），再跑go mod tidy
IDE 内置终端执行 go run 却提示 “command not found” 或找不到模块
VS Code、GoLand 的集成终端默认不加载 shell 配置文件（如 ~/.zshrc），导致 GOPATH、GOROOT、PATH 为空。这不是 IDE bug，是终端启动方式差异。
- VS Code：在
settings.json中加"terminal.integrated.profiles.linux": { "bash": { "path": "/bin/bash", "args": ["-l"] } }（-l表示 login shell，会读配置） - GoLand：设置 → Tools → Terminal → Shell path 改为
/bin/zsh -l或/bin/bash -l - 更稳妥的做法：在项目根目录下放一个
.env文件（需配合 direnv），或直接在 IDE 终端里手动source ~/.zshrc - 注意：GoLand 的 “Run Configurations” 里若勾选了 “Add content root to module path”，可能干扰
go run .行为，建议取消
go run . 和 go run main.go 行为不一致，有时报 “no Go files in current directory”
go run . 是按当前模块解析，而 go run main.go 只认单个文件——两者触发的构建逻辑不同，尤其在多 package 项目里容易出错。
立即学习“go语言免费学习笔记（深入）”；
-
go run .要求当前目录有go.mod，且至少一个package main文件；它会自动找所有main包，但不跨子目录 -
go run main.go最简单可靠，适合单文件调试；但若main.goimport 了同目录外的包，而该包没在go.mod里声明，就会报错 - 真正要运行整个服务？优先用
go run ./cmd/myapp（假设入口在cmd/myapp/main.go），明确指定路径，避免歧义 - CI 或部署脚本里永远用
go build -o bin/app ./cmd/myapp，而不是go run—— 后者只适合开发机快速验证
go run 就可能静默失败或报错信息完全不对路。 
