VSCode配置Golang环境详细教程

Golang小白一枚，正在不断学习积累知识，现将学习到的知识记录一下，也是将我的所得分享给大家！而今天这篇文章《VSCode配置Golang环境教程》带大家来了解一下##content_title##，希望对大家的知识积累有所帮助，从而弥补自己的不足，助力实战开发！

VSCode配置Go开发环境需安装Go、启用官方Go插件、自动或手动安装gopls等工具，正确设置GOROOT/GOPATH，新建Go文件即可获得语法高亮与智能提示，通过launch.json配置可调试运行。

直接在 VSCode 中配置 Go 开发环境不复杂，关键是装对工具、配好路径、启用核心插件。下面分几步说清楚，照着做基本就能跑起来。

安装 Go 语言环境

先确认系统已安装 Go，并且 GOROOT 和 GOPATH 配置正确（Go 1.16+ 默认启用 module，GOPATH 不再强制要求，但建议仍设好）。打开终端运行：

• go version —— 确认输出类似 go version go1.22.0 darwin/arm64
• go env GOROOT GOPATH —— 检查路径是否合理（如 /usr/local/go 和 ~/go）

若未安装，去官网 https://go.dev/dl/ 下载对应系统安装包，安装后重启终端生效。

安装 VSCode 并启用 Go 插件

从官网下载安装最新版 VSCode（https://code.visualstudio.com/），然后在扩展市场搜索 “Go”，安装由 Go Team at Google 发布的官方插件（图标是蓝色 G 字）。

安装后，VSCode 会提示安装依赖工具（如 gopls、dlv、goimports 等），点击 “Install All” 即可。如果提示失败，可手动运行：

• go install golang.org/x/tools/gopls@latest
• go install github.com/go-delve/delve/cmd/dlv@latest

完成后重启 VSCode。

配置工作区与代码提示

新建一个文件夹（比如 hello-go），用 VSCode 打开该文件夹，在其中创建 main.go：

package main

import "fmt"

func main() {
    fmt.Println("Hello, VSCode + Go!")
}

保存后，VSCode 应自动识别 Go 文件并显示语法高亮、跳转、补全。若无响应，检查状态栏右下角是否显示 Go 版本和 gopls 状态（应为 “Running”）。

如需自定义行为（如保存时自动格式化），可在项目根目录建 .vscode/settings.json，写入：

{
  "go.formatTool": "goimports",
  "go.lintOnSave": "file",
  "go.useLanguageServer": true
}

调试与运行

在 main.go 左侧行号旁点击设断点，按 Ctrl+Shift+D（Win/Linux）或 Cmd+Shift+D（Mac）打开调试面板，点击“运行和调试” → “create a launch.json file” → 选 “Go” → “Delve”。VSCode 会生成 .vscode/launch.json。

默认配置已支持当前文件调试，按 F5 即可启动调试。也可以终端中直接运行 go run main.go 或 go build 测试。

基本上就这些。不需要改太多设置，只要 Go 可执行文件在 PATH、gopls 装好了、插件启用，VSCode 就能很好支持日常 Go 开发。

本篇关于《VSCode配置Golang环境详细教程》的介绍就到此结束啦，但是学无止境，想要了解学习更多关于Golang的相关知识，请关注golang学习网公众号！