go version报错说明go未正确加入path或安装失效；需验证goroot、path配置，macos/linux要source shell配置，windows检查系统环境变量，再通过where go或which go确认路径。
go version 命令报错或无输出
说明 Go 二进制没进系统 PATH，或者安装根本没生效。Windows 上常见于手动改了安装路径但没同步更新 Path；macOS/Linux 则多因 shell 配置文件选错（比如改了 ~/.bashrc 却用 zsh 终端），或没执行 source。
实操建议：
- Windows：打开命令提示符，运行
where go，若无结果，说明%GOROOT%\bin没加进系统变量Path；检查“系统属性 → 高级 → 环境变量”中Path是否含C:\Go\bin（默认路径）或你自定义的路径 - macOS/Linux：运行
echo $SHELL确认当前 shell，再编辑对应配置文件（zsh 用户改~/.zshrc，bash 用户改~/.bash_profile），添加两行：export GOROOT=/usr/local/go和export PATH=$PATH:$GOROOT/bin，然后执行source ~/.zshrc（或对应文件） - 别依赖安装程序自动配置——尤其 macOS 用 pkg 安装后，
GOROOT虽设好，但go命令仍可能找不到，必须手动确认$PATH包含$GOROOT/bin
go env 显示 GOPATH 是 ~/go，但新建项目不生成 go.mod
这是新手最常困惑的点：不是环境没配好，而是没主动启用模块模式。Go 1.11+ 默认支持模块（modules），但只有在项目根目录下执行 go mod init 或首次 go get 时才会创建 go.mod。空目录里直接 go run main.go 不会自动初始化模块。
实操建议：
- 进到你的项目目录（比如
D:\myproject），先运行go mod init myproject（模块名可任意，但建议用有意义的短名或假 URL，如example.com/myproject） - 如果提示
go: modules disabled by GO111MODULE=off，说明模块被手动关了，运行go env -w GO111MODULE=on开启 -
GOPATH在模块模式下仅影响go install输出位置（即$GOPATH/bin），和项目结构无关；你现在完全可以把项目放在桌面、D 盘任意位置，不用非得塞进$GOPATH/src
go get 下载第三方包超时或 404
国内直连 proxy.golang.org 基本不可用，这是真实网络限制，不是你配置错了。错误信息通常是 Get "https://proxy.golang.org/...": dial tcp xxx:443: i/o timeout 或返回 404 Not Found。
实操建议：
- 设置国内代理：运行
go env -w GOPROXY=https://goproxy.cn,direct（推荐goproxy.cn，稳定且免认证） - 验证是否生效：运行
go env GOPROXY，输出应为https://goproxy.cn,direct - 如果公司内网有自建代理，可替换为内部地址，但末尾一定要加
,direct，否则私有模块无法拉取 - 临时关闭代理调试用：
go env -w GOPROXY=direct，但日常开发不建议长期关闭
VS Code 中 Go 扩展提示 “The Go language server crashed”
本质是 gopls（Go 的语言服务器）启动失败，90% 情况是 GOPATH 或 GOROOT 路径含中文、空格或符号，或 VS Code 没读到 shell 的环境变量（尤其 macOS/Linux 启动方式不对）。
实操建议：
- 在终端里先运行
go env GOPATH和go env GOROOT，复制输出路径，打开 VS Code 设置（Cmd+,或Ctrl+,），搜索go.gopath和go.goroot，粘贴纯英文路径（如C:\Users\name\go，不能是C:\用户\name\go） - macOS 用户：不要从 Finder 双击打开 VS Code，而要用终端命令
code启动，否则它读不到~/.zshrc里的GOROOT - 重启 VS Code 后，新建
main.go，等左下角 Go 图标不再显示 “Loading…”，再试Ctrl+Space触发补全——成功即说明gopls已就绪
go env，盯着输出里的 GOPATH、GOROOT、GOPROXY 三项，比反复重装更省时间。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
