VS Code + go CLI + gopls 是最轻量可控的 Go 开发组合；需安装 Go 扩展和 Shell Command 扩展，配置 .vscode/settings.json 启用语言服务器、goimports 格式化，并正确初始化 go.mod；调试需安装 dlv 并配置 launch.json。
用 VS Code 配置 Go 开发环境，别装 GoLand 就对了
VS Code + go CLI + gopls 是当前最轻量、最可控、更新最及时的 Go 开发组合。GoLand 功能全但重、插件更新滞后、对模块路径和 GOBIN 的处理常有偏差，日常开发反而容易卡在 IDE 自身逻辑里。
关键前提是：你本地已安装正确版本的 go（建议 1.21+），且 $PATH 中能直接调用 go 命令。验证方式：
go version输出不报错且版本 ≥ 1.21。
必须安装的 VS Code 扩展和初始化设置
只装两个核心扩展就够了：Go（由 Go 团队维护，ID: golang.go）和 Shell Command: Install 'code' command in PATH（确保能从终端启动 VS Code）。
gopls 会随 Go 扩展自动下载，但首次打开 Go 文件时可能卡住——这是它在构建缓存。别关窗口，等终端底部状态栏出现 gopls: indexing... 后变 ready 即可。
立即学习“go语言免费学习笔记（深入）”；
在工作区根目录下建 .vscode/settings.json，写入以下最小必要配置：
{
"go.toolsManagement.autoUpdate": true,
"go.gopath": "",
"go.goroot": "",
"go.useLanguageServer": true,
"go.lintTool": "golint",
"go.formatTool": "goimports"
}
-
"go.gopath"和"go.goroot"留空，让扩展自动探测；手动填死路径是多数索引失败的根源 -
"go.useLanguageServer"必须为true，否则没有跳转、补全、诊断 -
"go.formatTool": "goimports"要提前用go install golang.org/x/tools/cmd/goimports@latest安装，否则保存时不格式化
module 初始化和 GOPATH 冲突怎么破
Go 1.16+ 默认启用 module 模式，go.mod 文件是项目唯一权威依赖声明。如果你在 $GOPATH/src 下新建项目却没运行 go mod init，VS Code 会反复提示 “no modules found”，gopls 无法加载包信息。
正确做法只有一步：
go mod init example.com/myapp（模块名不必真实可访问，但要符合域名/路径格式）。
常见误操作：
- 把项目放在
$GOPATH/src/github.com/xxx/yyy下，以为能自动识别——不行，没go.mod就是普通文件夹 - 执行
go get时不加-u或@latest，导致go.sum锁定旧版间接依赖，后续gopls解析类型时失败 - 用
go build成功但 VS Code 报红——检查是否在非 module 根目录打开了文件（比如打开了子目录里的.go文件，但go.mod在上层）
调试器 Delve 配置不生效？先看 launch.json 里这三行
VS Code 调试 Go 程序依赖 dlv，不是 go run。如果点 ▶️ 没反应或报 could not launch process: fork/exec /path/to/dlv: no such file or directory，说明 dlv 没装或路径不对。
运行：
go install github.com/go-delve/delve/cmd/dlv@latest，然后确认
dlv 在 $PATH 中（which dlv 有输出）。
在项目根目录创建 .vscode/launch.json，内容必须包含这三项：
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch Package",
"type": "go",
"request": "launch",
"mode": "test",
"program": "${workspaceFolder}",
"env": {},
"args": []
}
]
}
-
"mode": "test"或"mode": "exec"二选一，不能写"mode": "auto"（已废弃） -
"program": "${workspaceFolder}"表示调试整个 module，不是某个单文件；若要调试单文件，改用"mode": "exec"并指定"program": "${workspaceFolder}/main.go" - 不要手动改
"dlvLoadConfig"，新版gopls+dlv已自动处理变量加载深度
真正容易被忽略的是：调试前务必确保当前打开的文件属于该 module，且光标在 func main() 或测试函数内——否则调试器找不到入口。
