需依次完成五步：一、安装go工具链并配置PATH；二、安装vscode及官方Go扩展；三、初始化Go模块并配置工作区；四、通过go install安装Delve调试器并设置路径；五、配置launch.json定义调试参数。
如果您希望在本地编辑器中高效编写和调试 Go 语言程序，但尚未配置好开发环境，则可能是由于缺少必要的工具链、扩展或调试器支持。以下是完成 VSCode Go 开发环境搭建与调试的完整操作步骤：
本文运行环境：macBook Pro，macOS Sequoia。
一、安装 Go 工具链
Go 开发依赖官方提供的编译器、标准库和命令行工具（如 go build、go run、go test），必须先在系统中正确安装并配置环境变量，使 VSCode 能识别 go 命令。
1、访问 https://go.dev/dl/ 下载对应 macos 架构的最新 Go 安装包（如 go1.23.darwin-arm64.pkg）。
立即学习“go语言免费学习笔记（深入）”；
2、双击安装包完成图形化安装，安装程序会自动将 go 二进制文件放入 /usr/local/go/bin/ 目录。
3、在终端中执行 echo ‘export PATH=$PATH:/usr/local/go/bin’ >> ~/.zshrc && source ~/.zshrc，确保 go 命令全局可用。
4、执行 go version 验证安装结果，输出应类似 go version go1.23.0 darwin/arm64。
二、安装 VSCode 及 Go 扩展
VSCode 本身不内置 Go 支持，需通过官方维护的 Go 扩展提供语法高亮、代码补全、格式化、测试集成等核心功能，该扩展还负责自动下载依赖工具（如 gopls、dlv）。
1、前往 https://code.visualstudio.com/ 下载并安装最新版 VSCode 应用程序。
2、启动 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X），在搜索框中输入 Go。
3、在搜索结果中找到由 Go Team at Google 发布的官方扩展，点击“安装”按钮。
4、安装完成后，重启 VSCode 或重新打开一个 .go 文件，扩展将自动激活并提示安装所需工具。
三、配置 Go 模块与工作区
现代 Go 项目推荐使用模块（module）方式管理依赖，需在项目根目录初始化 go.mod 文件，并确保 VSCode 使用正确的 GOPATH 和 GOBIN 设置以避免路径冲突。
1、在终端中进入目标项目目录，执行 go mod init example.com/myproject 初始化模块文件。
2、在 VSCode 中打开该目录（File → Open Folder），右键点击任意 .go 文件选择“Open with Code”，确保工作区上下文正确。
3、按下 Cmd+, 打开设置，在搜索框中输入 go.gopath，确认其值为空（推荐使用模块模式，不依赖 GOPATH）。
4、在设置中搜索 go.toolsManagement.autoUpdate，将其设为 true，以便扩展自动获取 gopls、gofumpt 等工具。
四、安装 Delve 调试器
Delve（dlv）是 Go 官方推荐的调试器，VSCode 的 Go 扩展通过它实现断点、变量查看、步进执行等功能；必须单独安装并确保其可被 VSCode 调用。
1、在终端中执行 go install github.com/go-delve/delve/cmd/dlv@latest 安装 dlv 到 $GOPATH/bin 或模块 bin 目录。
2、执行 dlv version 验证安装，输出应包含版本号及构建信息。
3、在 VSCode 设置中搜索 go.delvePath，若自动检测失败，手动填入 /Users/yourname/go/bin/dlv（路径根据实际 $GOBIN 输出调整）。
4、新建一个 main.go 文件，写入含 main 函数的简单程序，在左侧行号区域点击设置断点，按 F5 启动调试，验证是否进入断点停顿状态。
五、配置 launch.json 调试参数
launch.json 文件定义了 VSCode 启动调试会话时的行为，包括程序入口、参数传递、环境变量注入等，是实现复杂调试场景（如子进程调试、远程调试）的基础。
1、在项目根目录下创建 .vscode/ 文件夹（若不存在），进入该目录。
2、在 VSCode 中按 Cmd+Shift+P，输入 Debug: Open launch.json，选择环境为 Go。
3、在生成的 launch.json 中，确认配置项 program 指向主程序文件（如 ${workspaceFolder}/main.go）。
4、如需传参调试，添加 args 字段，例如：“args”: [“–verbose”, “test”]。
5、保存文件后，再次按 F5，VSCode 将依据该配置启动 dlv 并加载指定参数运行程序。