vscode中go开发必须配置gopls和go.mod：gopls需手动安装并加入path，网络受限时须设goproxy；go.mod为项目识别前提，缺失则功能降级；调试前需确保焦点在main.go且dlv已安装。
VSCode 能直接写 Go，但不配好工具链就等于没装——gopls 没跑起来，连 package main 都标红；go.mod 缺失，go run 直接报错“no Go files in current directory”。
go version 能跑通 ≠ VSCode 能开发 Go
很多用户执行 go version 成功后就以为环境齐了，结果在 VSCode 里打开 main.go，发现没有语法高亮、跳转失效、fmt 提示“unresolved import”。根本原因不是 Go 没装好，而是 VSCode 没法调用语言服务器。
-
gopls必须手动安装或由扩展触发安装，它不随 Go 安装包自带 - 安装后二进制默认落在
$GOPATH/bin/gopls（Windows 是%GOPATH%\bin\gopls.exe），该路径必须在系统PATH中，否则 VSCode 找不到 - 如果网络受限，
go install golang.org/x/tools/gopls@latest会卡住或失败，此时要先设代理：go env -w GOPROXY=https://goproxy.cn,direct - 验证是否生效：在 VSCode 中打开任意
.go文件，底部状态栏应显示gopls (running)，不是gopls (starting...)或空白
go mod init 不是可选项，是启动前提
Go 1.16+ 默认强制模块模式，VSCode 的 Go 扩展依赖 go.mod 识别项目根和依赖范围。空文件夹里只放一个 main.go，VSCode 会认为“no workspace detected”，所有功能降级为纯文本编辑。
- 必须在项目根目录执行
go mod init example.com/myapp（模块名可任意，但建议用域名格式） - 执行后生成
go.mod和首次运行时的go.sum，VSCode 才会激活完整支持 - 不要把项目放在
$GOPATH/src下硬套旧习惯——现代 Go 不需要GOPATH，VSCode 设置里go.gopath留空更安全 - 如果已建好文件夹但忘了初始化，直接终端进该目录补上
go mod init即可，VSCode 通常几秒内自动重载
F5 调试失败？大概率是没打开对的文件
VSCode 的 Go 调试器（dlv）不依赖当前活动文件名，但依赖当前工作区能否解析出可执行入口。常见报错如 “could not launch process: fork/exec ./main: no such file or directory” 或直接跳过断点，往往不是配置问题，而是上下文错位。
- 按
F5前，确保编辑器焦点在含有package main和func main()的.go文件上（通常是main.go） - 不要在
go.mod、go.sum或其他非源码文件上按 F5 - 调试前确认
dlv已安装：go install github.com/go-delve/delve/cmd/dlv@latest，且其路径也在PATH中 - 首次调试可能弹出配置提示，选 “Go: Launch Package” 即可，生成的
.vscode/launch.json里"mode": "auto"足够应付绝大多数单文件项目
真正卡住人的地方，从来不是“怎么装”，而是“装完之后 VSCode 没反应”——那多半是 gopls 没跑起来，或 go.mod 根本不存在。别急着改设置，先看状态栏有没有 gopls (running)，再确认当前目录下有没有 go.mod。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
