go version报“不是内部或外部命令”说明path未生效；windows下msi安装虽自动添加c:\go\bin到path，但需重启终端，若缺失则手动在系统环境变量中添加该路径。
go version 命令没反应，PATH 没配对
装完 Go 后执行 go version 报错“不是内部或外部命令”，基本就是 PATH 没生效。Windows 上 MSI 安装器通常会自动加 %GOROOT%\bin 到系统 PATH，但有时被杀毒软件拦截或用户手动改过环境变量，导致失效。
实操建议：
- 先确认
GOROOT是否存在：在 CMD 里运行echo %GOROOT%，正常应输出类似C:\Program Files\Go - 检查
PATH是否含%GOROOT%\bin：运行echo %PATH%，搜索Go\bin字样 - 若缺失，手动添加：
setx PATH "%PATH%;%GOROOT%\bin"（仅对新 CMD 窗口生效） - Mac/Linux 用户注意 shell 类型：用
zsh的别写.bash_profile，改完记得source ~/.zshrc
go mod init 失败：GOPROXY 被墙
新建项目跑 go mod init example.com/hello 卡住几秒后报错 Get "https://proxy.golang.org/..." : dial tcp: i/o timeout，是国内网络无法直连官方代理所致。
实操建议：
- 国内推荐用
https://goproxy.cn或https://mirrors.cloud.tencent.com/go/ - 执行命令一次性设好：
go env -w GOPROXY=https://goproxy.cn,direct - 验证是否生效：
go env GOPROXY应返回刚设置的地址 - 如果公司内网有私有 proxy，可设为
http://your-proxy:8080，末尾仍保留,direct
go run main.go 提示 “cannot find package”
常见于把代码放在非模块根目录下，比如直接丢在 C:\Users\name\Desktop 运行，go 找不到 go.mod 就按旧规则去 GOPATH 查，而现代项目根本不依赖它。
实操建议：
- 务必先建空目录，cd 进去再初始化：
mkdir hello && cd hello && go mod init hello -
main.go必须放在该目录下，且首行是package main - 不要手动创建
GOPATH目录结构（如src/github.com/user/repo），Go Modules 模式下这纯属多余 - 编辑器打开整个项目目录（而非单个 .go 文件），否则 VS Code 的 Go 插件可能加载失败
macOS 上 brew install go 后 go version 显示旧版本
brew 安装的是最新版，但终端仍显示老版本，说明 shell 加载了旧的 PATH 项，比如 /usr/local/bin/go 是之前手动安装残留的。
实操建议：
- 查实际调用路径：
which go，看输出是不是/opt/homebrew/bin/go（Apple Silicon）或/usr/local/bin/go（Intel） - 若不是 brew 路径，删掉旧 bin：
sudo rm /usr/local/bin/go - 检查 shell 配置文件（
~/.zshrc或~/.profile），删掉重复的export PATH=.../go/bin行 - 重启终端或重载配置：
source ~/.zshrc
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
