go代码提示失效、module初始化失败、断点不命中、test无响应等问题，主因分别是gopls未启动、未执行go mod init/tidy、未安装配置dlv、测试文件/函数命名不规范。
安装 Go 扩展后还是没代码提示？
VSCode 里写 fmt. 按不了 Ctrl+Space，或者提示“no packages found”，大概率是 gopls 没跑起来，而不是扩展装错了。
检查点：
– 确认已安装 Go（go version 能输出版本）；
– VSCode 设置里搜 go.gopls.enabled，确保是 true；
– 关闭所有文件夹，打开一个真实存在的 Go 工作区（即含 go.mod 或 main.go 的目录），gopls 不会在纯空文件夹里启动；
– 终端执行 go env GOPATH，如果路径含空格或中文，gopls 很可能静默失败——换到英文路径重装 Go。
Go module 初始化失败：cannot find module providing package
新建项目后运行 go run main.go 报这个错，说明当前目录没被识别为 module 根，go 去全局 GOPATH 找包了，但你用的是模块模式。
解决办法：
– 在项目根目录执行 go mod init example.com/myapp（名字只是占位，不真联网）；
– 立刻执行 go mod tidy，它会自动补依赖、写 go.sum；
– 别手动改 go.mod 里的 module 行再删 go.sum——gopls 会卡住，重启 VSCode 也不行，得删掉整个 go.mod 和 go.sum，再重新 init + tidy。
调试时断点不命中，或显示 “No debug adapter”
点击左侧打断点，但运行 Debug 时灰色不可用，常见原因是没装 dlv（Delve）调试器，或版本不匹配。
Go 配置库，使用 spf13/viper — 分层优先级（flag > env >file > KV > default），提供 BindPFlag/BindPFlags、SetEnvPrefix + SetEnvKeyReplace 等功能。
操作步骤：
– 终端执行 go install github.com/go-delve/delve/cmd/dlv@latest（注意是 @latest，不是 @master）；
– 安装完确认 dlv version 输出正常；
– VSCode 设置中搜 go.delvePath，填入 dlv 的绝对路径（macOS/Linux 可用 which dlv，Windows 用 where dlv）；
– 如果项目用了 //go:build 约束，调试前先确认当前文件满足构建条件，否则 dlv 直接跳过该文件。
Go test 在 VSCode 里点 “Run Test” 没反应
右键函数名选 “Run Test”，底部终端一闪而过，或根本没启动，通常是因为测试文件名不合规，或测试函数签名不对。
必须同时满足：
– 文件名以 _test.go 结尾（比如 utils_test.go，不能是 test_utils.go）；
– 测试函数名以 Test 开头，且首字母大写，参数必须是 *testing.T（比如 func TestAdd(t *testing.T)）；
– 当前打开的文件是测试文件本身，VSCode 的 “Run Test” 不支持从非测试文件触发；
– 如果项目有 go.work，确保工作区打开的是 go.work 所在目录，否则 go test 找不到模块上下文。
复杂点在于：VSCode 的 Go 扩展会缓存测试状态，改完函数名或文件名后，有时需要关掉当前测试文件标签页，再重新打开，才能刷新右键菜单选项。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
