go开发环境搭好的标志是go命令可运行、go mod能自动拉包、编辑器支持跳转和补全；windows下go version报错需检查path环境变量是否生效，必须重启终端验证；国内用户须配置go111module=on与goproxy=https://goproxy.cn,direct；vs code补全失效主因是gopls未正确安装或未识别go.mod模块路径。
go 命令能直接运行、go mod 能自动拉包、编辑器能跳转和补全——这三件事都做到，才算真正搭好了可用的 Go 开发环境。其他都是锦上添花。
Windows 安装后 go version 报“不是内部或外部命令”？
这是最常卡住新手的第一步，本质是环境变量没生效，不是没装好。
- .msi 安装包虽会自动写入
Path，但**必须关闭所有已打开的 CMD/PowerShell 窗口再重开**，否则系统不读新变量 - 验证方式：新开终端，执行
where go（Windows）或which go（macOS/Linux），应返回类似C:\Go\bin\go.exe的路径 - 如果仍失败，手动检查系统环境变量里的
Path是否包含C:\Go\bin（默认路径）或你自定义的安装目录下的\bin
为什么 go run main.go 成功，但加了第三方库就报错？
因为没启用模块管理，或代理没配对——Go 1.16+ 默认开启 GO111MODULE=on，但国内用户不配 GOPROXY 几乎必失败。
- 执行这三条命令（永久生效）：
go env -w GO111MODULE=ongo env -w GOPROXY=https://goproxy.cn,directgo env -w GOSUMDB=sum.golang.org -
direct很关键：当代理找不到包时，会自动回源官方校验，避免因镜像滞后导致校验失败 - 验证是否生效：
go env | findstr GOPROXY（Windows）或go env | grep GOPROXY（macOS/Linux）
VS Code 打开 .go 文件提示“install tools”，点完还是没补全？
不是插件没装，而是工具链下载被墙或超时，尤其 gopls（语言服务器）必须成功启动，否则所有智能功能失效。
- 先确保
GOPROXY已配置（见上一条），再在 VS Code 终端里手动运行：go install golang.org/x/tools/gopls@latest - 安装完成后重启 VS Code，或按
Ctrl+Shift+P→ 输入 “Developer: Reload Window” 强制重载 - 如果仍报错，检查
gopls是否在$GOPATH/bin或$GOBIN下存在；现代 Go（1.21+）推荐不设GOBIN，让工具自动装到$GOPATH/bin
go mod init 该填什么名字？填错会影响后续发布吗？
模块名只是导入路径前缀，不影响本地运行，但填错会在协作或发布时引发路径不一致问题。
- 本地练习可填任意合法标识符，如
go mod init hello；但若将来要推送到 GitHub，建议直接填完整路径：go mod init github.com/yourname/projectname - 模块名不强制与文件夹名一致，但保持一致能减少混淆；
go mod tidy会根据import语句自动修正依赖版本，不会改模块名 - 一旦生成
go.mod，就别手动改第一行的module xxx——除非你明确要迁移整个导入路径
import 必须用完整路径（比如 import "github.com/gin-gonic/gin"），不能再用旧式 GOPATH 下的相对路径。这点在从老教程迁移时特别容易踩坑。golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
