VS Code中Go插件无反应、调试失败，90%因gopls未安装或go命令不在VS Code可见PATH中；需先验证终端中which go路径并将其加入shell配置，再从终端启动code，接着手动运行Go: Install/Update Tools安装gopls和dlv@latest，并通过Go: Locate Configured Go Tools确认路径正确。
VS Code 里 Go 插件没反应、没提示、调试失败，90% 是因为 gopls 没装上，或 go 命令根本不在 VS Code 能看到的 PATH 里——不是插件有问题，是环境没对齐。
go 命令在终端能用，但 VS Code 里报 command not found
这是最常卡住的第一步。VS Code 启动时不一定加载你的 shell 配置（比如 macOS 从 Dock 点开、Windows 用快捷方式），导致它压根不知道 go 在哪。
- 先在系统终端（不是 VS Code 内置终端）运行
which go，确认路径，比如/usr/local/go/bin/go或/opt/homebrew/bin/go - macOS：把该路径加进
~/.zshrc或~/.bash_profile，然后从终端执行code --no-sandbox启动 VS Code - Linux：确保桌面环境的
PATH包含go路径，或改用~/.profile配置并重新登录 - Windows：检查系统环境变量
Path是否含%GOROOT%\bin，且 VS Code 是重启后打开的 - 验证：在 VS Code 内置终端里直接输
go version，必须有输出；否则所有后续步骤都白搭
装了 golang.go 插件，但代码没提示、跳转失效
插件本身不带语言服务，gopls 才是提供补全、诊断、跳转的核心。它不会自动下载，得手动触发安装。
- 打开任意一个
.go文件，或确保工作区根目录下有go.mod（哪怕空文件）或至少一个.go文件 - 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Go: Install/Update Tools，勾选gopls并确认 - 如果卡在 “Initializing” 超过 10 秒，大概率是代理问题：运行
go env -w GOPROXY=https://goproxy.cn,direct - 私有模块？补上
go env -w GOPRIVATE=git.internal.company.com/*，不然gopls会试图走代理查它，直接超时 - 状态栏右下角应显示
Go和gopls v0.14.x类似字样，没出现说明没跑起来
点击调试按钮，提示 dlv 未找到或断点不命中
dlv 不是插件自带，也不随 gopls 一起装。Go 1.21+ 对 dlv 版本更敏感，旧版会直接报 API mismatch。
立即学习“go语言免费学习笔记（深入）”；
- 手动安装最新版：
GO111MODULE=on go install github.com/go-delve/delve/cmd/dlv@latest - 验证：
dlv version输出中Delve Debugger Version应 ≥ 1.22.0，且Go version行匹配你本地go version - VS Code 里按
Ctrl+Shift+P→Go: Locate Configured Go Tools，确认dlv路径指向刚装的那个二进制（通常在$GOPATH/bin/dlv） - 调试配置别写错：
mode别用已废弃的"auto"；模块项目用"mode": "exec"+"program": "./main.go"，单文件测试用"mode": "test" - cgo 项目必须加
"env": {"CGO_ENABLED": "1"}，否则符号加载失败，断点全灰
launch.json 配置看似正常，但调试器启动就退出
VS Code 调试行为高度依赖 launch.json 的字段组合，尤其是 program、mode、env 三者是否协同。
- 别把
program指向main.go就完事——模块项目必须让dlv知道怎么构建，推荐用"mode": "exec"并确保program是可执行文件路径（如"./bin/myapp"），或改用"mode": "test"跑测试 - macOS Ventura / M1/M2 上调试必加：
"env": { "GODEBUG": "mmap=1" }，否则dlv进程可能挂起无响应 - 传参调试？用
"args"字段，比如"args": ["--config", "dev.yaml"]；测试函数要指定名字："args": ["-test.run", "TestFoo"] - 别混用多个 Go 版本管理器（
asdf、gvm），它们可能导致dlv编译时链接错libgo，调试器一启动就崩溃
真正容易被忽略的，是 gopls 和 dlv 实际运行时所处的环境——它们看到的 PATH、GO111MODULE、GOPROXY，未必和你在终端里敲命令时一致。每次怀疑配置失败，先切到 VS Code 内置终端，手动跑一遍 go env、dlv version、gopls version，比反复重装插件管用得多。
