go version命令报command not found说明go二进制未加入path，非未安装；linux需手动添加export path=$path:/usr/local/go/bin并source配置文件，macos用homebrew安装后应写入~/.zshrc，windows需新开终端验证。
go version 命令没反应或报 command not found
说明 go 二进制文件没进系统 PATH，不是“没装好”，而是“找不到”。Windows 和 macOS 安装 .msi/.pkg 通常自动配置，但 Linux 手动解压后必须自己加路径。
实操建议：
- Linux 用户检查是否执行了
export PATH=$PATH:/usr/local/go/bin并source ~/.zshrc（或~/.bashrc） - macOS 使用 Homebrew 安装后，如果用 zsh（默认），确认写入的是
~/.zshrc而非~/.bash_profile - Windows 用户安装完立刻新开一个 PowerShell 或 CMD——旧终端不会自动加载新 PATH
- 运行
which go（macOS/Linux）或where go（Windows）定位实际路径，再反向验证环境变量
go mod init 报错：‘go: go.mod file already exists’
这是常见误操作：在已有 go.mod 的目录里重复执行 go mod init。Go 不允许覆盖已有模块定义，尤其当项目已依赖其他模块时，强行重初始化会破坏版本锁定。
实操建议：
- 先用
ls -l go.mod确认文件存在，别硬删——除非你明确要重置整个依赖树 - 想改模块名？直接编辑
go.mod第一行module xxx即可，无需重新 init - 刚建错目录？
cd .. && rm -rf wrong-dir，再新建正确路径 - 如果只是想拉取依赖，用
go mod tidy，它会按现有go.mod自动补全和清理
GOPROXY 没配导致 go get 或 go mod download 极慢甚至超时
默认代理 https://proxy.golang.org 在国内直连基本不可用，不配代理时 Go 会 fallback 到直接拉 GitHub，而 GitHub 的 raw CDN 经常被干扰，表现为卡在 “verifying github.com/xxx” 或 403 错误。
实操建议：
- 立即执行：
go env -w GOPROXY=https://goproxy.cn,direct（推荐 goproxy.cn，稳定、同步快） - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct - 如果公司有私有代理，把
https://goproxy.cn换成内网地址，direct保留用于跳过私有模块 - 注意：设了
GOPROXY后，go list -m all和go mod download会明显变快，但首次go run仍可能触发下载，别误以为失败
go run main.go 成功但 go build 无输出文件
go build 默认把二进制输出到当前目录，**不带文件名参数时不会生成可执行文件**，而是静默编译通过。很多人等半天没看到 myapp 文件，以为失败了。
实操建议：
- 想生成指定名字的可执行文件：用
go build -o myapp main.go - 想让 go build 输出到当前目录且用包名命名：直接
go build（当前目录下必须有且仅有一个main包） - 检查当前目录是否有
main.go，且里面是package main+func main()—— 少一个都会编译出错或静默忽略 - Mac/Linux 上生成的文件无后缀；Windows 下是
.exe，别用ls后忘了./myapp去运行
go.mod 被多层嵌套污染、代理只设了一半、build 输出路径和预期不一致……这些地方不报错，但后续所有命令都会开始“不对劲”。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
