go version报错command not found说明PATH未包含Go二进制路径；需检查GOROOT是否正确且$GOROOT/bin（Linux/macOS）或%GOROOT%\bin（Windows）已加入PATH，macOS用Homebrew安装时路径通常为/opt/homebrew/bin/go或/usr/local/bin/go。
go version 命令报错：command not found
说明你没把 go 二进制文件所在路径加入 PATH，系统根本找不到这个命令。
常见错误现象：bash: go: command not found 或 PowerShell 中提示“无法识别的命令”。
- Linux/macOS：确认
GOROOT（比如/usr/local/go）是否正确，然后检查PATH是否包含$GOROOT/bin；用echo $PATH看一眼有没有/usr/local/go/bin这类路径 - Windows：检查系统环境变量里
PATH是否含%GOROOT%\bin（不是%GOROOT%），且GOROOT值是完整路径（如C:\Program Files\Go），不能带中文或空格 - macOS 使用 Homebrew 安装时，
go默认装在/opt/homebrew/bin/go（Apple Silicon）或/usr/local/bin/go（Intel），它通常已自动加入PATH；若未生效，重启终端或运行source ~/.zshrc
go env 显示 GOPATH 为空或指向错误目录
Go 1.16+ 默认启用 Go Modules，GOPATH 不再强制要求，但某些工具（如 go get 旧用法、部分 IDE 插件）仍会依赖它。空值不等于出错，但若你手动建项目在 $GOPATH/src 下，就容易失败。
使用场景：你想用传统 GOPATH 模式开发，或某些老教程/脚本硬编码了 $GOPATH/src 路径。
立即学习“go语言免费学习笔记（深入）”；
- 设为个人工作区（推荐）：
go env -w GOPATH=$HOME/go（Linux/macOS）或go env -w GOPATH=%USERPROFILE%\go（Windows） - 别直接改 shell 配置文件里的
export GOPATH=...—— Go 1.14+ 之后go env -w会写入$HOME/.goenv（或 Windows 注册表），优先级更高，手动 export 反而可能冲突 - 验证方式：
go env GOPATH，不是echo $GOPATH—— 后者只反映 shell 变量，不一定被 Go runtime 读取
go mod init 失败：‘cannot determine module path’
这是新项目初始化时最常卡住的地方，本质是 Go 不知道该给你的模块起什么名字，不是环境没装好，而是当前目录缺少上下文。
参数差异：go mod init 后必须跟一个模块路径（module path），比如 go mod init github.com/yourname/project，不能只敲 go mod init。
- 如果你只是本地练手，不想关联远程仓库，用任意合法路径即可，例如
go mod init example.com/hello—— 只要符合域名格式，Go 不真去解析它 - 路径中不能有空格、中文、下划线开头，也不能以
.或..开头；推荐全小写字母 + 连字符 - 如果已在 Git 仓库根目录，且远程地址是
https://github.com/user/repo，直接go mod init会自动推导为github.com/user/repo—— 但前提是git remote get-url origin能返回有效 URL
VS Code 提示 “Failed to install tools: go: cannot find main module”
这不是 Go 环境问题，而是 VS Code 的 Go 插件试图在没有 go.mod 的目录里安装 gopls 等工具，结果 Go Module 机制拒绝执行。
性能影响：插件功能（跳转、补全、诊断）全部失效，编辑器退化成纯文本高亮器。
- 最简解法：在项目根目录运行
go mod init example.com/temp（随便起个名），生成go.mod文件，再按 Ctrl+Shift+P →Go: Install/Update Tools - 别在用户主目录或桌面直接开项目 —— 那里没有
go.mod，插件反复尝试失败后会缓存错误状态，需重启 VS Code 才能重试 - 国内用户务必提前配置代理：
go env -w GOPROXY=https://goproxy.cn,direct，否则gopls编译依赖会超时失败
go mod 初始化时机、GOPROXY 是否生效、以及 VS Code 插件对模块上下文的强依赖——这些细节不会出现在安装包的“下一步”按钮里。 
