需依次完成五步：一、安装Go工具链并验证go version与GOPATH；二、安装VSCode及官方Go扩展；三、手动安装gopls等依赖工具；四、用go mod init初始化模块工作区；五、配置launch.json并验证断点调试。
如果您希望在本地计算机上开始使用 Go 语言进行开发，但尚未配置好 VSCode 编辑器的 Go 支持，则可能是由于 Go 工具链、VSCode 扩展或工作区设置未正确安装与关联。以下是完成该环境搭建的多种可行路径：
本文运行环境：MacBook Air，macOS Sequoia。
一、安装 Go 工具链
Go 开发依赖于官方提供的编译器、构建工具和标准库，必须先在系统中安装 Go 运行时及命令行工具，否则 VSCode 无法执行语法检查、代码格式化或调试操作。
1、访问 https://go.dev/dl/ 下载对应 macOS 架构的最新稳定版 .pkg 安装包。
立即学习“go语言免费学习笔记（深入）”；
2、双击运行下载的安装包，按向导完成默认安装流程。
3、打开终端，执行 go version 命令，确认输出类似 go version go1.22.5 darwin/arm64 的结果。
4、执行 go env GOPATH 查看模块路径，若为空则需手动添加 export GOPATH=$HOME/go 到 shell 配置文件（如 ~/.zshrc）并执行 source ~/.zshrc。
二、安装 VSCode 及 Go 扩展
VSCode 本身不内置 Go 支持，需通过官方维护的扩展提供智能提示、跳转定义、测试集成等核心功能；该扩展依赖 Go 工具链中的特定二进制文件，因此须确保 Go 已就绪后再安装。
1、前往 https://code.visualstudio.com/ 下载并安装最新版 VSCode 应用程序。
2、启动 VSCode，点击左侧活动栏的扩展图标（或按 Cmd+Shift+X）。
3、在扩展搜索框中输入 Go，找到发布者为 Go Team at Google 的官方扩展，点击“安装”按钮。
4、安装完成后，关闭并重新打开 VSCode，使扩展初始化生效。
三、配置 Go 扩展依赖工具
Go 扩展默认会尝试自动安装一组辅助工具（如 gopls、dlv、goimports），但因网络策略或权限限制常失败；需手动触发安装并验证各组件状态，确保编辑器功能完整可用。
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
1、在 VSCode 中打开任意 .go 文件，右键选择 Go: Install/Update Tools。
2、在弹出的工具列表中，勾选全部选项（包括 gopls、dlv、goimports、gofumpt 等）。
3、点击“OK”，等待终端窗口显示 All tools successfully installed 提示。
4、按下 Cmd+Shift+P，输入 Go: Current Environment 并回车，确认输出中 GOPATH 与 GOROOT 路径均正确解析。
四、初始化 Go 模块工作区
VSCode 的 Go 功能需识别项目为合法 Go 模块，否则无法启用语义高亮、错误诊断和代码补全；新建项目时必须显式运行 go mod init 命令生成 go.mod 文件，以确立模块根目录边界。
1、在终端中创建新目录，例如执行 mkdir ~/projects/hello-go && cd ~/projects/hello-go。
2、运行 go mod init hello-go，生成包含模块声明的 go.mod 文件。
3、在该目录下新建 main.go 文件，写入基础代码：package main\n\nimport \"fmt\"\n\nfunc main() {\n fmt.Println(\"Hello, Go!\")\n}。
4、在 VSCode 中通过 File → Open Folder 打开该目录，确认底部状态栏出现 Go (gopls) 标识且无红色波浪线报错。
五、启用调试与运行支持
调试能力依赖于 Delve（dlv）调试器与 launch.json 配置协同工作；仅安装扩展不足以触发断点调试，必须为当前工作区生成专用的调试启动配置，并验证其可执行性。
1、在 VSCode 中打开命令面板（Cmd+Shift+P），输入并选择 Debug: Open launch.json。
2、若提示“没有 launch.json”，点击“create a launch.json file”，再选择环境为 Go。
3、在生成的 .vscode/launch.json 文件中，确认配置项 \"mode\": \"auto\" 和 \"program\": \"${workspaceFolder}\" 存在且未被注释。
4、在 main.go 的 fmt.Println 行左侧单击设置断点，按 F5 启动调试，观察调试控制台是否输出 Hello, Go! 并暂停在断点处。
