go version无响应需先确认PATH是否生效：Windows需重启终端，macOS/Linux要检查shell配置文件（如~/.zshrc）并source，确保Go的bin目录已加入PATH。
go version 命令没反应？先确认 PATH 是否生效
安装完 Go 后执行 go version 报错 “command not found” 或直接无输出，基本是 PATH 没配对。Windows 用户容易漏掉重启终端（CMD/PowerShell 不会自动继承新环境变量），macOS/Linux 用户常因 shell 类型不同（bash/zsh）导致 ~/.bashrc 配了但 ~/.zshrc 没同步。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- Windows：右键“此电脑”→“属性”→“高级系统设置”→“环境变量”，检查
Path里是否含C:\Program Files\Go\bin（或你自定义的安装路径下的\bin） - macOS/Linux：运行
echo $PATH，确认输出里有/usr/local/go/bin或你设的$GOROOT/bin；若没有，编辑对应 shell 配置文件（~/.zshrc更常见），加一行export PATH=$PATH:/usr/local/go/bin，再执行source ~/.zshrc - 验证是否真生效：新开一个终端窗口再试
go version，别在当前已打开的窗口里反复source
go run hello.go 报错 “no Go files in current directory”
这是新手最常卡住的地方：你以为在跑文件，其实 go run 默认只找当前目录下 package main 的 .go 文件，且不递归子目录。如果你把 hello.go 放在 ~/go/src/hello/ 里，但当前工作目录是 ~/go，就会报这个错。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 先用
pwd（macOS/Linux）或cd（Windows）确认当前路径，再用ls或dir看有没有hello.go - 如果文件在子目录，两种解法：
go run hello/hello.go（显式指定路径），或cd hello && go run hello.go - 更推荐初始化模块：
go mod init example/hello，然后保持hello.go在同一目录下，再go run .——这个点号代表当前模块，比写文件名更可靠
go get 下载超时或 403？必须设 GOPROXY
国内直连 proxy.golang.org 基本不可用，不设代理的话，go mod tidy 或任何带网络依赖的操作都会卡死或报 failed to fetch、403 Forbidden 错误。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（推荐）或https://mirrors.aliyun.com/goproxy/ - 顺手关掉私有仓库限制：
go env -w GONOPROXY=""（留空即可，避免内部模块被代理拦截） - 验证：运行
go env GOPROXY，输出应为设定值；再试go mod download github.com/gin-gonic/gin，几秒内完成即成功 - 注意：不要用
http://开头的代理地址，Go 1.13+ 默认拒绝非 HTTPS 代理
go build 生成的可执行文件不带扩展名？这是正常行为
Linux/macOS 下 go build main.go 生成的是无后缀的 main，不是 bug，是 Unix-like 系统惯例。Windows 下才生成 main.exe。很多人误以为“没编译成功”，其实是没意识到跨平台差异。
实操建议：
立即学习“go语言免费学习笔记（深入）”；
- 确认生成：执行
go build main.go后，用ls -l看是否有新文件，权限位含x（如-rwxr-xr-x）说明是可执行文件 - 运行它：
./main（Linux/macOS），不是main；Windows 下才是main.exe - 想统一命名？加
-o参数：go build -o app main.go→ 输出app（Linux/macOS）或app.exe（Windows） - 构建时注意
GOOS和GOARCH：跨平台交叉编译需显式指定，比如GOOS=windows GOARCH=amd64 go build -o app.exe main.go
go mod init 后模块路径的命名规范——它不只是个名字，会直接影响后续 import 路径和 vendor 行为。比如写成 go mod init myproject，之后所有本地 import 都得用 "myproject/utils"，而不是相对路径。这点一旦定错，重构成本远高于重装 Go。 
