go version验证失败说明goroot和path配置错误：windows需将%goroot%\bin加入系统path，macos/linux需export $goroot/bin到shell配置文件，并新开终端验证；临时可直接运行/go安装路径/bin/go version确认二进制正常。
go version 验证失败，说明环境变量没配对
安装完 Go 后执行 go version 报 “command not found” 或 “不是内部或外部命令”，基本就是 GOROOT 和 PATH 没对上。Windows 用户常把 GOROOT 设成 C:\Go，却忘了把 %GOROOT%\bin 加进系统 PATH；macOS/Linux 用户则容易漏掉 $GOROOT/bin 的 export。
实操建议：
- 先确认安装路径：Windows 查注册表或安装向导默认路径；macOS 用
which go反推GOROOT；Linux 多在/usr/local/go - 临时验证：直接运行
/usr/local/go/bin/go version（替换成你的真实路径），能出版本号就说明二进制没问题 - PATH 配置后，新开终端再试——旧终端不会自动 reload shell 配置文件
go mod init 报错 “no Go files in current directory”，其实是没进对目录
新手常卡在 go mod init 这一步，提示找不到 Go 文件，但其实只是当前目录下没有 .go 文件——而 go mod init 并不要求必须有源码，它只负责生成 go.mod。真正的问题往往是：你在空目录里执行了命令，又误以为必须先写好 main.go 才能初始化模块。
实操建议：
-
go mod init可以在任意空目录执行，比如mkdir hello && cd hello && go mod init hello - 如果真想立刻跑起来，建个最简
main.go：package main import "fmt" func main() { fmt.Println("hello") } - 别用中文路径或带空格的路径——
go mod在某些旧版本（如 1.16 之前）会解析失败
国内 go get 超时或 404，代理配置不生效的三个常见原因
执行 go get github.com/gin-gonic/gin 卡住或报 module github.com/gin-gonic/gin: reading https://proxy.golang.org/...: 404 Not Found，大概率是代理没起作用，而不是网络问题。
实操建议：
- 检查是否开了模块模式：
go env GO111MODULE必须是on，不是auto（尤其老项目迁移时容易忽略） - 代理设置要用
go env -w，不是写 shell 环境变量：go env -w GOPROXY=https://goproxy.cn,direct - 如果用了私有仓库或企业内网，
direct必须保留，否则内部模块拉不到——https://goproxy.cn,direct是正确写法，逗号不能少
VS Code 装了 Go 插件却无法跳转定义，多半是 gopls 没跑起来
编辑器里 Ctrl+Click 无效、没有参数提示、保存不自动格式化，不是插件装错了，而是语言服务器 gopls 没启动成功。VS Code 的 Go 插件默认依赖 gopls 提供智能提示，但它需要项目有合法的 go.mod 且 GOPATH 不干扰模块查找。
实操建议：
- 打开命令面板（Ctrl+Shift+P），运行
Go: Install/Update Tools，勾选gopls单独安装 - 确保工作区根目录下有
go.mod，且go env GOMOD输出的是该文件的绝对路径 - 关掉 GOPATH 模式影响：在 VS Code 设置里搜
go.gopath，设为 null 或留空；同时确认go.useLanguageServer是 true
GO111MODULE=on 不开，GOPROXY 就形同虚设；gopls 找不到 go.mod，编辑器功能就全哑火。这些环节串在一起，错一个，整个链路就断。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
