vscode运行go代码失败主因是gopls未启动、dlv未找到或项目未识别为模块；需手动安装gopls/dlv、配置goproxy、确保含go.mod的模块根目录被打开，并从终端启动vscode以继承环境变量。
VSCode 写 Go 语言缺的从来不是“某个依赖包”，而是 gopls 没跑起来、dlv 找不到、或者项目压根没被识别为 Go 模块——装错位置、代理失效、启动方式不对，三者任一出问题，代码提示就消失、断点就灰掉、格式化就失灵。
go version 能跑，但 VSCode 里没提示、跳转失败
这是最典型的“环境已装，服务未启”现象。VSCode 的 Go 插件（golang.go）不自带语言能力，全靠 gopls 提供语义分析。它不会静默启动，也不会自动重试失败安装。
- 打开命令面板（
Ctrl+Shift+P/Cmd+Shift+P），运行Go: Install/Update Tools，**必须手动勾选gopls** —— 其他工具可以稍后补，但没gopls就等于没语言服务器 - 确保当前工作区是 Go 模块：终端执行
go mod init example.com/foo（哪怕只是空模块），否则gopls会报no module found并拒绝加载 - 检查状态栏右下角是否显示
Go和gopls版本；若一直卡在Initializing...，大概率是GOPROXY没生效，立即在终端运行：go env -w GOPROXY=https://goproxy.cn,direct
点击调试按钮报 “Failed to launch: could not find Delve”
VSCode 默认用 dlv 调试，但它不关心你 PATH 里有没有，只认配置路径或内置查找逻辑。很多用户装了 dlv 却仍报错，是因为 VSCode 进程根本没读到那个路径。
- 先手动安装：
go install github.com/go-delve/delve/cmd/dlv@latest，安装后二进制落在$GOPATH/bin/dlv（Linux/macOS）或%GOPATH%indlv.exe（Windows） - 确认该路径已加入系统
PATH：在 VSCode 内置终端中运行which dlv（macOS/Linux）或where dlv（Windows），必须有输出 - 更稳妥的做法是显式指定路径：在
.vscode/settings.json中加一行："go.delvePath": "/Users/you/go/bin/dlv"（macOS/Linux）或"go.delvePath": "C:\Users\you\go\bin\dlv.exe"（Windows，注意双反斜杠） - 调试前务必确保项目根目录有
main.go，且launch.json中"mode"设为"auto"或"exec"，不要用"test"模式去跑主程序
保存不格式化、goimports 不生效
VSCode 默认不开启保存即格式化，且 Go 扩展默认格式化工具是 gofmt，而它不处理 import 排序——这就是为什么你删了 import，保存后又自动回来了。
- 打开设置，搜索
editor.formatOnSave，设为true - 再搜
go.formatTool，设为goimports（不是gofmt，也不是留空） - 如果
goimports还没装，运行：go install golang.org/x/tools/cmd/goimports@latest - 注意：某些旧版插件会把
go.formatTool错写成go.formatTool（拼错），检查 settings.json 是否存在拼写错误
为什么从终端执行 code . 才正常，双击图标就失效？
VSCode 双击启动时，macOS/Linux 下通常以非登录 shell 启动，压根不 source ~/.zshrc 或 ~/.bash_profile，导致 PATH、GOPATH、GOPROXY 全部丢失。这不是 bug，是 Unix 进程环境继承机制决定的。
- Mac/Linux 用户：永远用终端执行
code --no-sandbox .（或code .）打开项目，这是唯一可靠方式 - Windows 用户：必须通过「系统属性 → 环境变量」添加
GOROOT、GOBIN、GOPATH，并把它们都加进PATH；仅在 PowerShell 或 CMD 里set是无效的 - 验证方法：在 VSCode 内置终端中运行
echo $PATH（macOS/Linux）或echo %PATH%（Windows），确认含/usr/local/go/bin和$GOPATH/bin
真正卡住人的地方，往往不是“该装什么”，而是 gopls 初始化失败时没有明确报错、dlv 路径在 VSCode 进程里不可见、以及 go.mod 缺失导致整个语言服务直接退场——这些都不会弹窗提醒，只会安静地让编辑器变回记事本。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
