Go环境真正可用需通过三关：go env正常输出GOROOT/GOPATH/GOBIN；go list std或go mod download std不报错；VSCode能用dlv调试且状态栏显示Go(Modules)。
go 环境能跑起来、vscode 能断点调试，才是真搭好了。光装完 go 命令能用，不等于开发环境就 ready —— 很多人卡在调试器连不上、工具下载失败、模块初始化报错这三步上。
验证 go 是否真正可用，不只是看 version
运行 go version 有输出，只说明 GOROOT 和 PATH 没大问题；但真正要写代码，还得过三关：
-
go env必须能正常打印，重点看GOROOT（安装路径）、GOPATH（工作区）、GOBIN（可执行文件落点）是否合理，尤其 Windows 用户常因空格路径（如C:\Program Files\Go）导致后续工具安装失败 - 执行
go list std，如果卡住或报cannot find module providing package，大概率是GO111MODULE没开或代理失效 - 运行
go mod download std（Go 1.21+ 支持），能快速拉下标准库索引，比等go run时慢吞吞下载更早暴露网络问题
vscode 调试失败的常见硬伤
装了 Go 扩展、点了 F5 却弹出 Failed to launch: could not launch process 或直接跳过断点——不是代码问题，而是调试器没配对：
- 确保已安装
dlv：运行go install github.com/go-delve/delve/cmd/dlv@latest，完成后检查dlv version能否输出；Windows 用户注意，若提示permission denied，需以管理员身份运行终端再执行安装 - VS Code 的
launch.json中mode必须为exec（编译后调试）或auto（推荐），别手误写成core或留空；program字段必须指向可执行文件路径（如"./main"），不能写"main.go" - Go 扩展默认启用语言服务器（
gopls），但它依赖go.mod存在；新建项目务必先go mod init example.com/hello，否则断点灰色不可用
国内环境下 go get / dlv 安装总失败怎么办
不是网络差，而是默认配置没切到国内链路：
- 执行
go env -w GOPROXY=https://goproxy.cn,direct（goproxy.cn稳定性优于proxy.golang.org） - 同时关闭校验干扰：
go env -w GOSUMDB=off（仅开发机用；生产环境应保留校验，改用GOSUMDB=sum.golang.org+ 代理） - 若仍超时，检查是否被本地杀毒软件拦截了
go进程的外网连接（尤其 Windows Defender 实时防护）；临时禁用后重试
go mod init 后为什么 fmt.Println 不高亮、没提示
这不是插件坏了，是 VS Code 没识别到模块上下文：
立即学习“go语言免费学习笔记（深入）”；
- 确认当前打开的是「整个模块根目录」，不是某个子文件夹；比如
go mod init example.com/hello后，VS Code 必须打开hello/文件夹，而非hello/main.go单文件 - 检查状态栏右下角是否显示
Go (GOPATH)—— 若显示这个，说明还在旧模式；应看到Go (Modules)才对；手动触发Go: Restart Language Server命令刷新 -
gopls启动需要几秒，刚打开项目时提示延迟属正常；但若 30 秒后仍无 import 补全，运行gopls -rpc.trace -v check .查日志，常见原因是go.sum里有损坏 checksum 或模块路径含非法字符
go 工具链各组件之间那层隐式契约：dlv 依赖 go 版本兼容性，gopls 依赖 go.mod 结构，而所有这些又卡在代理和校验开关的组合上。少调一个 env，就可能让调试器静默失败。 
