需依次完成五步:一、安装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 初始化模块文件。
10分钟内自己学会PHP其中,第1篇为入门篇,主要包括了解PHP、PHP开发环境搭建、PHP开发基础、PHP流程控制语句、函数、字符串操作、正则表达式、PHP数组、PHP与Web页面交互、日期和时间等内容;第2篇为提高篇,主要包括MySQL数据库设计、PHP操作MySQL数据库、Cookie和Session、图形图像处理技术、文件和目录处理技术、面向对象、PDO数据库抽象层、程序调试与错误处理、A
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 并加载指定参数运行程序。









