在 VSCode 中搭建 Go 开发环境,只需四步：安装 Go、安装 VSCode 及 Go 插件、配置代理加速、最后写一个 Hello World 验证。

下面以Windows系统为例说明(文末会补充 macOS 的区别),每一步的操作都很清晰。

第1步：安装 Go 语言环境

1. 下载安装包
   访问 Go 官方下载页面 go.dev/doc/install。如果官网慢,可以用国内镜像站,比如 https://golang.google.cn/dl/ 或 https://studygolang.com/dl。
   根据你的系统选择对应版本(Windows 选windows-amd64安装包)。

2. 安装与验证
   双击下载的.msi文件,一路点击 "Next" 即可。
   安装完成后,打开命令提示符(cmd)或PowerShell,输入以下命令并回车：

   bash

   go version

   如果看到类似go version go1.24.4 windows/amd64的提示,就说明 Go 安装成功了。

💡 关于环境变量
新版 Go 安装程序会自动配置好GOROOT并将Go\bin添加到系统 PATH 中,通常你不需要手动配置。如果好奇,GOROOT就是 Go 的安装目录,比如C:\Program Files\Go。而GOPATH(工作区目录)的概念在新版 Go 中已不推荐使用,现在官方推荐使用Go Modules(模块)来管理项目,可以不用特意设置它。

第2步：安装 VSCode 和 Go 插件

1. 安装 VSCode
   去 code.visualstudio.com 下载并安装。

2. 安装 Go 插件
   打开 VSCode,点击左侧活动栏的“扩展”图标(或按Ctrl+Shift+X),在搜索框中输入Go。找到由 "Go Team at Google" 官方发布的插件,点击“安装”。

第3步：安装 Go 工具链(重点)

安装完插件后,VSCode 会提示你安装官方工具链(如代码补全gopls、调试工具dlv等)。但关键一步来了：为避免因网络问题安装失败,需要先配置代理。

1. 配置代理
   打开 VSCode 终端(菜单栏“终端” -> “新建终端”),执行以下命令,使用国内代理：

   bash

   go env -w GOPROXY=https://goproxy.cn,direct

2. 安装工具
   在 VSCode 中按Ctrl+Shift+P打开命令面板,输入Go: Install/Update Tools,然后回车。
   在弹出的列表中全选所有工具,点击“确定”等待安装完成。过程可能需要一两分钟。

第4步：编写 Hello World 验证

1. 新建文件
   在你电脑的任意位置新建一个文件夹(如hello)。在 VSCode 中点击“文件” -> “打开文件夹”,选择这个新建的文件夹。

2. 初始化模块
   打开 VSCode 终端(`Ctrl + ``),执行以下命令初始化一个 Go 模块：

   bash

   go mod init hello

   执行后,文件夹里会自动生成一个go.mod文件,这就是模块的配置文件。

3. 编写代码
   在 VSCode 中新建一个文件,命名为main.go。输入以下代码：

   go

   package main import "fmt" func main() { fmt.Println("Hello, VSCode!") }

4. 运行
   你可以直接在 VSCode 终端中输入命令运行：

   bash

   go run main.go

   或者在main.go文件编辑区右上角,直接点击那个 ▶️ 运行三角图标,选择“Run file”。

   如果看到控制台输出Hello, VSCode!,恭喜你,环境搭建成功！