VSCode无法识别Go或调试失败，90%是gopls未运行或dlv安装路径错误：需从终端执行code .启动、确认gopls在$GOBIN下、手动安装gopls/dlv、配置launch.json并确保项目含go.mod。
VSCode 无法识别 Go 或调试失败，90% 是因为 gopls 没跑起来，或 dlv 没装对位置，而不是插件没点安装。
go version 能跑通，但 VSCode 还报 “Go language server is not available”
这是最典型的路径错位问题：终端里 go 可用，不代表 VSCode 启动时能读到同一个 $PATH。
- 必须从终端执行
code .打开项目，双击图标启动的 VSCode 会丢失 shell 配置（比如~/.zshrc里的export PATH） - 检查
gopls是否真在$GOBIN下：ls $GOBIN/gopls；若不存在，说明工具没装进预期目录 -
GOBIN建议显式设为$HOME/go/bin（不是默认的$GOPATH/bin），避免和旧版 GOPATH 混淆 - VSCode 设置里
go.goroot留空——填错路径会导致gopls启动静默失败，且无明确错误提示
点“Install All”卡住，或提示 “failed to install gopls”
VSCode Go 插件内置的自动下载逻辑，在国内网络下大概率超时或 404，必须手动干预。
- 先临时设置代理：
export GOPROXY=https://goproxy.cn,direct（macOS/Linux），Windows 用户在 PowerShell 中用$env:GOPROXY="https://goproxy.cn,direct" - 手动安装关键工具：
go install golang.org/x/tools/gopls@latest和go install github.com/go-delve/delve/cmd/dlv@latest - 确认安装结果：
which dlv应输出$GOBIN/dlv，不是/usr/local/bin/dlv—— 后者是 Homebrew 安装的，VSCode 默认不认 - 装完别急着重启，先关掉所有 VSCode 窗口，再从终端
code .重开
断点不生效、调试按钮灰掉、launch.json 报错 “program not found”
调试失败几乎都源于 launch.json 配置和项目结构不匹配，而不是 Delve 本身有问题。
- 确保项目根目录有
main.go，且里面包含func main()；program字段不能指向子目录或单个文件（除非你明确用"mode": "test"） -
launch.json必须放在.vscode/目录下，内容至少含："mode": "auto"和"program": "${workspaceFolder}" - 如果项目还没初始化模块，VSCode 会拒绝加载调试器——必须先在终端运行
go mod init example.com/foo - Windows 用户注意：
dlv安装后需额外执行一次dlv version，否则首次调试可能因权限弹窗阻塞
格式化保存无效、import 自动整理不工作
这不是插件故障，而是两个开关没打开，且格式化工具选错了。
- VSCode 设置中开启
editor.formatOnSave，同时确认go.formatTool设为goimports（不是gofmt，后者不管理 import） -
go.useLanguageServer必须为true；禁用它等于放弃全部语义功能，包括格式化触发逻辑 - 如果保存后仍无反应，检查右下角状态栏是否显示
gopls正在运行；若显示 “idle” 或空白，说明语言服务器根本没加载成功 - 某些老项目用了
vendor/目录，需在settings.json加上"go.toolsEnvVars": { "GO111MODULE": "on" }强制启用模块模式
真正卡住人的地方，往往不是某一步没做，而是多个环境变量、工具路径、配置开关之间存在隐性依赖。比如 dlv 装对了，但 gopls 没起来，调试面板就完全不可用；又比如 go.mod 没初始化，连 go formatTool 的选项都不会出现。顺序和验证比操作本身更重要。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
