go version报command not found是path未生效，非go未安装；windows需手动添加go安装路径的bin目录到系统path并重启终端，macos/linux需在~/.zshrc中追加export path=$path:/usr/local/go/bin并执行source ~/.zshrc。
go version 报 command not found
不是 Go 没装上，是系统根本找不到 go 这个可执行文件。Windows 下最常见的是安装时没勾选 “Add Go to PATH”，或自定义路径（比如装到 D:\Go）后没手动把 D:\Go\bin 加进系统环境变量的 Path；macOS/Linux 则常因改了 ~/.zshrc 却忘了 source ~/.zshrc，或者终端压根没读对配置文件（Catalina 后默认用 zsh，但有人还在改 ~/.bash_profile）。
实操建议：
- 先确认
go文件是否存在：Windows 上检查C:\Go\bin\go.exe，macOS/Linux 上运行ls /usr/local/go/bin/go - Windows：右键“此电脑”→属性→高级系统设置→环境变量→在“系统变量”的
Path里新增一行，填完整路径如C:\Go\bin（不要加引号，也不要末尾加反斜杠） - macOS/Linux：在
~/.zshrc末尾加export PATH=$PATH:/usr/local/go/bin，然后运行source ~/.zshrc - 改完必须关掉所有终端窗口，新开一个再试
go version——旧窗口不会自动继承新PATH
go mod init 失败或报 cannot determine module path
Go 1.13+ 强制模块模式后，go mod init 不再接受随意起名。它会拒绝含大写字母、短横线、数字开头的模块名（比如 go mod init my-app 或 go mod init 2024api 都会失败），也会在空目录或桌面直接运行时无法推断合法路径。
实操建议：
- 进项目根目录再执行，别在桌面或临时文件夹里写完
main.go就跑命令 - 必须显式指定模块名，推荐类域名格式：
go mod init example.com/hello（哪怕不上传 GitHub，也别省略example.com/前缀） - 如果已生成错误的
go.mod，先删掉它再重试，否则 Go 会沿用旧声明继续报错 - 模块名不强制匹配文件夹名，但 import 路径必须和
go.mod第一行的module值完全一致
go run 正常但 go build 后二进制一运行就 panic: failed to initialize module
这不是环境变量问题，是构建时缺失模块上下文。典型触发场景是用了 embed、runtime/debug.ReadBuildInfo() 或某些依赖模块元数据的库，但构建命令没在 go.mod 所在目录下执行。
实操建议：
- 必须在含
go.mod的目录下运行go build，不能cd进子目录再构建（例如项目结构为project/cmd/myapp/main.go，构建命令得在project/目录下执行：go build -o myapp ./cmd/myapp） - CI 脚本里容易忽略当前工作目录，建议显式切回模块根：
cd "$(dirname "$(realpath "$0")")/.." - 验证是否在模块内：运行
go env GOMOD，输出应为具体路径（如/path/to/project/go.mod），为空则说明当前不在模块作用域
VS Code 里 gopls 不工作、跳转失效、状态栏卡在 Loading…
不是插件坏了，是 VS Code 启动时根本没加载你的 shell 环境变量（比如 GOPROXY、GO111MODULE）。双击桌面图标打开的 VS Code，大概率没读 ~/.zshrc，也就看不到你配的代理地址。
实操建议：
- 别双击图标，改用终端执行
code .打开项目（确保当前 shell 已source过配置） - 或在 VS Code 设置中手动透传：
"go.toolsEnvVars": { "GOPROXY": "https://goproxy.cn,direct" } - 验证是否生效：命令面板（Ctrl+Shift+P）运行
Go: Locate Configured Tools，看gopls的环境变量里有没有GOPROXY - 如果用了私有模块，记得同时设
GO111MODULE=on和GOPRIVATE=git.internal.company.com/*，否则 fallback 到公共 proxy 会失败
go version 成功，不代表 gopls 就能拿到 GOPROXY；go mod init 成了，也不代表 go build 在任意子目录都能正确解析 embed 资源。每个环节都得单独确认。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
