本地轻量开发流：Go语言环境搭建与VSCode结合-Golang-PHP中文网

Go本地轻量开发需确保go命令可用、gopls补全正常、dlv断点有效；关键在于稳定：GOPROXY须设为https://goproxy.cn,direct，gopls和dlv须用go install安装并验证路径，launch.json配置正确，格式化工具推荐gofumpt。

本地轻量开发流：go语言环境搭建与vscode结合

Go 语言在本地做轻量开发，不需要重装系统、不依赖 Docker、不硬套 CI 流程，只要 go 命令能跑、gopls 能补全、dlv 能断点，就足够了。关键不是“全”，而是“稳”——工具链别断、代理别失效、路径别错乱。

go version 能跑，但 go mod init 报错：GOPROXY 没配对

常见现象是执行 go mod init myapp 后卡住几秒，然后报类似 no matching versions for query "latest" 或直接超时。这不是 Go 安装问题，而是模块下载源被墙。

国内用户必须设 GOPROXY，推荐用 https://goproxy.cn,direct（阿里云镜像）或 https://goproxy.io,direct
设置方式：终端执行 go env -w GOPROXY=https://goproxy.cn,direct（macOS/Linux）或 go env -w GOPROXY=https://goproxy.cn,direct（Windows PowerShell）
验证是否生效：运行 go env GOPROXY，输出应为设定值；再试 go mod init test，应秒级完成
注意：如果用了公司内网代理，direct 部分不能删，否则私有模块会失败

VSCode 装了 Go 扩展，但没提示、没跳转：gopls 没装或路径不对

VSCode 的 Go 支持核心是 gopls（Go Language Server），不是插件本身。插件只是个壳，真正干活的是它。

首次打开 .go 文件时，底部状态栏若出现 Installing tools，点击后选 Install All —— 这步必须做，不能跳过
如果卡住或失败，手动安装：go install golang.org/x/tools/gopls@latest，完成后重启 VSCode
检查 gopls 是否可用：终端执行 which gopls 或 gopls version，应返回路径和版本号
VSCode 设置里别动 "go.gopath" —— Go 1.16+ 默认不用 GOPATH，留空或删掉这项，否则反而干扰模块识别

断点调试 F5 按下没反应：dlv 没装或 launch.json 配置错

VSCode 默认调试器是 Delve（dlv），不是 go run。没装 dlv 或配置不匹配，F5 就只是“假装在调试”。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

先装 dlv：go install github.com/go-delve/delve/cmd/dlv@latest
确保项目根目录有 main.go，且含 func main() —— Delve 不支持调试无入口的包
.vscode/launch.json 必须存在且内容正确，最简配置是：

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch Package",
      "type": "go",
      "request": "launch",
      "mode": "auto",
      "program": "${workspaceFolder}"
    }
  ]
}