go version报错说明path未配置，windows安装.msi通常自动添加c:\go\bin到path，而macos/linux需手动编辑~/.zshrc或~/.bashrc添加export path=$path:/usr/local/go/bin并source生效。
go version 命令报错或不识别，说明环境变量没生效
安装完 Go 后直接在终端执行 go version 报 command not found: go，基本就是 PATH 没配对。Windows 安装 .msi 包通常会自动加 C:\Go\bin 到系统 PATH，但 macOS/Linux 手动解压或 Homebrew 安装后必须手动配置。
- macOS（zsh 默认）：编辑
~/.zshrc，追加export PATH=$PATH:/usr/local/go/bin（Homebrew 安装则路径是/opt/homebrew/bin或/usr/local/bin，用which go确认） - Linux：编辑
~/.bashrc或~/.profile，同样加export PATH=$PATH:/usr/local/go/bin - 改完务必运行
source ~/.zshrc（或对应文件），否则新终端才生效 - 验证：新开一个终端，再跑
go version，看到类似go version go1.22.0 darwin/arm64就成功了
go mod init 初始化失败，提示 “cannot determine module path”
这是新手最常卡住的地方：在空目录下直接 go mod init 不带参数，Go 无法推断模块名，就会报这个错。它不是 bug，是设计使然——Go 要求每个模块有唯一、可解析的导入路径。
- 正确做法：进到项目根目录后，显式指定模块路径，例如
go mod init example.com/myapp（域名部分可以是假的，但格式要像 URL） - 如果只是本地练手不想起名，用
go mod init myproject也行，但注意：这种无域名的模块名不能被别人go get引入，仅限本地开发 - 别在
$GOPATH/src下初始化模块——Go Module 模式下GOPATH已退居二线，项目可放在任意位置 - 初始化后会生成
go.mod文件，里面第一行module xxx就是你的模块标识，后续所有import都基于它解析
VS Code 运行 Go 文件报 “package xxx is not in GOROOT”
错误信息里出现 package mypro/user is not in GOROOT，本质是 Code Runner 插件默认用 go run 直接执行单个文件，忽略了模块上下文和依赖关系，导致 Go 编译器误以为你在试图 import 标准库外的包到 $GOROOT。
- 根本解法：修改 VS Code 的
code-runner.executorMap设置，把 Go 对应项改成"go": "cd $dir && go run *.go" - 为什么有效？
cd $dir确保工作目录是项目根（含go.mod），*.go让 Go 自动识别主包和依赖，而不是孤立编译一个文件 - 顺手检查：确保你已开启模块模式，运行
go env -w GO111MODULE=on（Go 1.16+ 默认开启，但旧版本或某些 Docker 环境可能关着） - 替代方案：不用 Code Runner，直接终端进项目目录跑
go run .（点号代表当前模块），更可靠
go get 下载第三方包超时或失败
国内直连 proxy.golang.org 基本不可用，这是网络环境导致的客观事实，不是配置错误。
- 立即生效的代理设置：
go env -w GOPROXY=https://goproxy.cn,direct（direct表示对私有仓库走直连） - 验证是否生效：
go env GOPROXY应输出https://goproxy.cn,direct - 如果公司内网有自建代理，替换为内部地址，例如
https://goproxy.internal.company.com - 注意：代理只影响
go get和模块下载，不影响go run或go build本身
go run 看似能跑通却无法 import 自定义包，或者 go get 卡死不动。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
