用VSCode开发Go项目需正确安装Go、配置GOPATH、安装官方Go扩展并启用gopls，初始化go mod，设置formatOnSave和gofumpt格式化，才能实现高效编码、跳转、调试与自动补全。
用 VSCode 开发 Go 项目很舒服，关键是要装对扩展、配好工具链和工作区设置，避免踩坑。
安装 Go 和配置 GOPATH
先确认已安装 Go（go version 能输出版本），推荐使用官方二进制包安装，不建议用系统包管理器（如 apt 或 brew）装旧版。Go 1.16+ 默认启用 GO111MODULE=on，所以 GOPATH 不再是必须项，但 VSCode 的 Go 扩展仍会读取它来定位 workspace。可以保留默认 GOPATH（如 $HOME/go），或在终端中运行：
- go env -w GOPATH=$HOME/mygopath（设自定义路径）
- go env -w GOBIN=$HOME/mygopath/bin（确保 go install 装的工具可执行）
安装核心扩展：Go 官方插件
在 VSCode 扩展市场搜 “Go”，安装由 Go Team at Google 发布的官方扩展（ID：golang.go）。它不是“Go for Visual Studio Code”的旧版，注意认准作者。安装后重启 VSCode，首次打开 .go 文件时会提示安装依赖工具，选 Install All 即可。这些工具包括：
- gopls（语言服务器，提供补全、跳转、诊断）
- dlv（调试器，支持断点、变量查看）
- gofumpt（格式化，比 gofmt 更严格）
- gomodifytags（快速增删 struct tag）
如果自动安装失败，可手动运行：go install golang.org/x/tools/gopls@latest 等命令补全。
立即学习“go语言免费学习笔记（深入）”；
调整关键设置（settings.json）
按 Ctrl+,（Windows/Linux）或 Cmd+,（macOS）打开设置，切换到 JSON 模式编辑 settings.json，加入以下常用项：
- "go.formatTool": "gofumpt" —— 统一用 gofumpt 格式化
- "go.useLanguageServer": true —— 必须开启 gopls
- "go.toolsManagement.autoUpdate": true —— 自动保持工具最新
- "go.gopath": "/home/you/mygopath"（Linux/macOS）或 "go.gopath": "C:\\Users\\You\\mygopath"（Windows）—— 显式指定，避免探测错误
- "editor.formatOnSave": true —— 保存即格式化
初始化模块与调试准备
新项目务必先运行 go mod init example.com/myapp 初始化模块，否则 gopls 功能受限（比如无法解析依赖、跳转失效）。调试前，在项目根目录建 .vscode/launch.json，内容可简化为：
{
"version": "0.2.0",
"configurations": [
{
"name": "Launch Package",
"type": "go",
"request": "launch",
"mode": "test",
"program": "${workspaceFolder}",
"env": {},
"args": []
}
]
}
对 main 包，也可选 mode: "auto" 或 "exec"，VSCode 会自动识别入口。
基本上就这些。不复杂但容易忽略 GOPATH 和 go mod init，配完就能写代码、跳转、断点、格式化一气呵成。
