go version验证失败说明环境变量未生效；windows需检查path是否含%goroot%\bin（如c:\go\bin），macos/linux需确认~/.zshrc或~/.bash_profile中添加export path=$path:/usr/local/go/bin并执行source，且必须重启终端。
go version 验证失败，说明环境变量没生效
安装完 go 后运行 go version 报错 'go' is not recognized as an internal or external command（Windows）或 command not found: go（macOS/Linux），基本就是 PATH 没配对。
- Windows：检查系统变量
Path是否包含%GOROOT%\bin（如C:\Go\bin），不是C:\Go - macOS/Linux：确认
~/.zshrc或~/.bash_profile里写了export PATH=$PATH:/usr/local/go/bin，且执行过source ~/.zshrc - 别漏掉重启终端——改完配置不新开终端，旧 shell 进程根本读不到新
PATH
go mod init 报错“no Go files in directory”，其实是没进对目录
执行 go mod init myproject 提示该错误，不是命令写错了，而是当前目录下没有 .go 文件，或者你根本不在项目根目录。
-
go mod init只是生成go.mod，不要求已有代码；但某些旧版 Go（main.go，建议直接新建空目录再操作 - 确保你在目标项目文件夹里：
cd /path/to/your/project，再运行命令 - 模块名推荐用实际路径（如
github.com/username/project），避免后期换仓库时go get解析失败
go get 失败，大概率是 GOPROXY 没开或设错
国内拉取 github.com 依赖超时、404 或证书错误，99% 是没配代理。Go 1.13+ 默认启用模块模式，但不自动设代理。
- 运行
go env -w GOPROXY=https://proxy.golang.org,direct（官方代理，有时不稳定） - 更稳的国内镜像：
go env -w GOPROXY=https://goproxy.cn,direct - 如果公司内网禁外网，可设为
go env -w GOPROXY=direct，再配合私有 proxy 或 vendor 模式 - 顺手加一句：
go env -w GOSUMDB=off可跳过 checksum 校验（仅开发测试阶段，上线前务必关掉）
VSCode 里 import 灰掉、跳转失效，插件没认到 GOPATH
VSCode 安装了 Go 插件，但 fmt、net/http 等标准库标灰，Ctrl+Click 跳不到定义，多半是插件找不到 Go 工具链。
- 先在终端跑
which go（macOS/Linux）或where go（Windows），拿到真实路径 - VSCode 设置里搜
go.goroot，填入该路径（如/usr/local/go），不是GOPATH - 新版插件已弱化
GOPATH依赖，除非你用的是老项目或GO111MODULE=off，否则不用配go.gopath - 重启 VSCode —— 插件初始化只在启动时读一次配置，改完不重启等于没改
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
