go version报错说明path未配置，需将$goroot/bin加入环境变量；linux/macos编辑~/.zshrc添加export goroot=/usr/local/go和export path=$path:$goroot/bin，windows在系统变量中设置goroot与%goroot%\bin。
go version 命令报错或不识别
说明 Go 二进制文件没进 PATH，这是最常见卡点。安装后只解压了 /usr/local/go 或 C:\Program Files\Go，但没把 $GOROOT/bin 加进系统环境变量。
- Linux/macOS：检查
~/.bashrc或~/.zshrc是否有这行：export PATH=$PATH:$GOROOT/bin；$GOROOT必须已定义（如export GOROOT=/usr/local/go） - Windows：确认系统环境变量里
PATH包含%GOROOT%\bin，且GOROOT变量本身已设为 Go 安装路径（不是安装包所在目录） - 执行
source ~/.zshrc（或重启终端）后，再运行go version；若仍失败，直接试/usr/local/go/bin/go version看是否能跑通——能则纯是PATH问题
go mod init 报错 “cannot determine module path”
这是模块初始化时路径不合法导致的，不是权限或网络问题。Go 要求模块路径不能以 .、.. 开头，也不能含空格或非法字符，更不能在 $GOPATH/src 下直接初始化（旧习惯易踩坑）。
- 正确做法：任意干净目录下执行
mkdir myproject && cd myproject，再运行go mod init example.com/myproject（模块名可自定义，但建议用域名格式避免冲突） - 如果当前目录名含大写字母、连字符或中文，
go mod init会拒绝——改名再试，比如my-project→myproject - 不要在
$GOPATH/src/xxx里执行go mod init；现代 Go 已不依赖GOPATH，强行套用旧结构反而触发路径校验失败
GOPATH 还要不要配？
Go 1.16+ 默认启用模块模式，GOPATH 对依赖管理已无实质作用，但仍有两个实际用途：存放 go install 生成的可执行文件（如 gopls、dlv），以及部分老工具链的默认缓存位置。
- 推荐配置
GOPATH，但不必拘泥于$HOME/go；可以设为$HOME/.go或~/workspace/go，只要确保$GOPATH/bin在PATH中 - VS Code 的 Go 扩展、
gopls语言服务器等工具，会优先从$GOPATH/bin查找二进制，没配就可能提示 “command not found” -
go get（已弃用）和go install（新版）命令安装的工具，默认落地到$GOPATH/bin；不配就只能靠-o指定输出路径，麻烦
VS Code Go 扩展提示 “No workspace detected” 或无法跳转
本质是项目根目录缺少 go.mod 文件，或 VS Code 没识别到 Go 模块上下文。不是插件没装好，也不是 GOPATH 没设对。
- 打开项目根目录（含
go.mod的那个文件夹），而不是父级目录或某个子包目录 - 如果刚新建项目，先手动运行
go mod init xxx生成go.mod，再用 VS Code 打开该目录 - 检查状态栏右下角是否显示 Go 版本号和模块名；若显示 “Go (no modules)”，说明 VS Code 没检测到模块——删掉
go.mod重试，或执行go mod tidy强制刷新 - 不要依赖 “Open Folder” 打开整个硬盘或用户主目录，那会导致语言服务器过载，响应变慢甚至崩溃
PATH 决定命令能不能敲，go.mod 决定工具认不认项目，GOPATH 决定装好的工具放哪、能不能直接调。这些不是“配置完就一劳永逸”的开关，而是持续参与构建、运行、编辑的活部件。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
