核心是确保go命令可用和gopls语言服务器正常运行：需验证go version、go env及go111module=on，项目根目录下执行go mod init生成go.mod，安装gopls和dlv工具，配置goproxy代理，并在settings.json中启用editor.formatonsave和[go]语言专属格式化设置。
VS Code 搭建 Go 环境，核心就两件事：go 命令能跑通、gopls 语言服务器能连上。其余都是围绕这两点展开的细节。
go version 和 go env 能执行，但 go mod init 报错找不到模块
这说明 GOPATH 或 GO111MODULE 配置有问题，不是插件没装全。
- 先确认
go version和go env输出正常，尤其检查GO111MODULE是否为on（Go 1.16+ 默认开启，老版本需手动设） - 如果项目目录下没有
go.mod，go mod init会失败——它不接受空目录或非标准路径名（比如含空格、中文、特殊符号） - Windows 用户常见坑：
go mod init myproject在桌面或 OneDrive 同步目录下执行，可能因权限或同步延迟导致写入失败；建议先切到%USERPROFILE%\go\src下新建目录再试 - 执行
go mod init example.com/myproj比单纯go mod init更稳定，显式指定 module path 可绕过自动推导逻辑
VS Code 安装了 Go 插件，但 Ctrl+Click 跳不到定义
跳转失效基本等于 gopls 没起来，和插件本身关系不大。
- 打开命令面板（
Ctrl+Shift+P），输入Go: Install Tools并运行，重点确保gopls和dlv成功安装（其他工具如goimports可选） - 检查状态栏右下角是否显示
gopls (running)；若显示gopls (starting...)卡住，多半是代理问题——国内用户必须配GOPROXY=https://goproxy.cn,direct - 在项目根目录下运行
go list -m，若报no modules found，说明当前目录未被识别为 module 根，gopls就不会加载项目上下文 - 重启 VS Code 后仍无效，可尝试删除
$HOME/.cache/gopls（Linux/macOS）或%LOCALAPPDATA%\gopls（Windows），清缓存重载
保存时格式化失效，或提示 "go.formatTool" is deprecated
Go 1.21+ 废弃了 go.formatTool，改用 gopls 内置格式化，旧配置会冲突。
- 删掉
settings.json中所有以go.formatTool开头的行，包括注释掉的 - 确认
"editor.formatOnSave": true已启用，并且"[go]": { "editor.defaultFormatter": "golang.go" }存在（这是调用 gopls 的关键） - 如果用了
goimports或goformat，它们只在 Go gopls 的format命令，无需额外工具 - 格式化后 import 排序异常？检查
gopls配置里有没有"ui.completion.usePlaceholders": true，这个开关会影响组织导入行为
调试时断点不命中，或 dlv 启动失败
Delve 不是“装完就能用”，它依赖构建产物和调试符号，容易卡在编译环节。
- 确保项目能正常
go build出二进制文件；如果go run main.go都报错，调试器根本起不来 -
launch.json中的program字段必须指向可执行文件路径（如"${workspaceFolder}/main"），不能是.go源文件 - Windows 用户注意：默认构建产物是
.exe，program值要带后缀，否则 dlv 找不到目标 - 如果提示
could not launch process: fork/exec ... no such file or directory，大概率是dlv二进制不在PATH，或者权限不足（macOS 上可能需要全盘访问授权）
真正卡住人的从来不是“装什么”，而是环境变量、module 初始化、gopls 连接这三个环节的隐性依赖。每个步骤都得验证输出，而不是凭感觉往下走。
golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！
