Go安装后go version能运行但go run报“command not found”，根本原因是$PATH未包含Go的bin目录；macOS/Linux需在~/.zshrc中添加export PATH=$PATH:/usr/local/go/bin并source，Windows需在系统环境变量Path中新增C:\Go\bin并重启终端。
Go 语言环境搭建本身不难，但卡在 GOPATH、GOBIN、模块代理或 go install 失败上的人，往往不是不会装，而是没意识到 Go 1.16+ 默认启用 module 模式后，很多旧教程的配置逻辑已失效。
Go 安装后为什么 go version 能运行，但 go run 报 “command not found”？
常见于 macOS 或 Linux 下用二进制包手动解压安装，但没把 bin 目录加进 $PATH。Windows 用户则容易漏掉系统环境变量重启。
- 确认 Go 安装路径（如
/usr/local/go或~/go），检查其下的bin子目录是否存在go可执行文件 - Linux/macOS：在
~/.zshrc或~/.bashrc中追加export PATH=$PATH:/usr/local/go/bin（路径按实际调整），然后source ~/.zshrc - Windows：在“系统属性 → 高级 → 环境变量”中，编辑用户或系统级
Path，新增C:\Go\bin（注意路径结尾无反斜杠） - 验证：新开终端，运行
which go（macOS/Linux）或where go（Windows），确保返回真实路径
go mod init 报错 “cannot determine module path” 怎么办？
这是 module 初始化最常遇到的问题，本质是 Go 不知道该给当前项目起什么模块名——它需要一个合法的、符合语义的导入路径，而不是随便起个名字。
- 不能用
go mod init myproject这种纯本地名；推荐用域名前缀，比如go mod init example.com/myproject（即使没这个域名也 OK，仅作命名空间） - 若项目将来要开源，建议和代码托管地址一致，如 GitHub 仓库是
github.com/username/hello，就用go mod init github.com/username/hello - 如果只是本地练手且不想设域名，可强制指定：
go mod init example/hello（注意斜杠，不能用下划线或空格） - 初始化后检查生成的
go.mod文件第一行是否为module example.com/myproject，否则后续go get可能解析失败
国内拉不到 golang.org/x/... 包？代理必须开吗？
必须。Go 官方包域名被墙，不配代理就无法 go get 或 go build 含有 golang.org/x 依赖的项目（比如 golang.org/x/net、golang.org/x/sync）。
立即学习“go语言免费学习笔记（深入）”；
- 首选设置 GOPROXY：
go env -w GOPROXY=https://proxy.golang.org,direct（官方代理，国内有时慢） - 更稳方案：
go env -w GOPROXY=https://goproxy.cn,direct（七牛维护，延迟低，支持私有模块） - 如果公司内网限制外网，可搭配
GOINSECURE使用，例如go env -w GOINSECURE="corp.example.com"，让 Go 对特定域名跳过 TLS 校验 - 注意：
direct在代理列表末尾表示“仅对私有模块直连”，没有它，私有 Git 仓库会因代理转发失败
go install 命令找不到命令？你可能混淆了模块路径和二进制名
Go 1.16+ 的 go install 默认只认模块路径下的 main 包，且要求路径以 @version 结尾。直接 go install cmd/mytool 是无效的。
- 正确做法：先确保项目根目录有
go.mod，且cmd/mytool是子目录，内含main.go - 安装命令应为：
go install example.com/myproject/cmd/mytool@latest（模块路径 + 子命令路径 + 版本） - 若未打 tag，可用
@main或@v0.0.0-时间戳-哈希（go list -m -f '{{.Version}}' example.com/myproject可查） - 安装后二进制默认落在
$GOPATH/bin或$HOME/go/bin，确认该路径已在$PATH中，否则仍提示 command not found
真正麻烦的从来不是下载和解压，而是模块路径怎么写、代理怎么切、go install 的语法为什么突然变严格——这些细节一旦错位，错误信息又极其简略，人很容易反复试错。动手前花两分钟看一眼 go env 输出，比重装三遍更省时间。
