1. 下载并安装 Go 语言环境#

Go 语言（Golang）的安装非常简单，官方提供了一键式安装包。

• 官网下载：访问 Go 官方网站 https://go.dev/ 或国内镜像站 https://golang.google.cn/。
• Windows 下载指引：在下载页面选择 Windows 平台的 .msi 后缀安装包（通常为 go1.x.x.windows-amd64.msi）。
• 安装步骤：双击运行安装包，一路点击 Next 即可。建议保持默认安装路径 C:\Go，尽量不要修改。

TIP

Go 语言在早期需要手动配置 GOPATH 和 GOROOT 环境变量，但现代 Go 版本（支持 Go Modules）已经实现了全自动化。安装程序会自动把 C:\Go\bin 添加到你的系统 Path 中，完全不需要手动去敲高级系统设置。

2. 验证安装与环境配置#

安装完成后，我们需要验证系统是否成功识别了 Go 编译器，并开启现代包管理代理。

• 验证步骤：
  1. 按下 Win + r，输入 cmd 打开命令提示符。
  2. 输入以下命令检查版本：

     1
     go version
     

     如果输出类似 go version go1.26.x windows/amd64，说明安装成功。
• 开启 Go Modules 代理【必备】： 为了让你在后续下载第三方依赖包（如 Gin 框架、gRPC 等）时稳定丝滑，建议在终端中运行以下两条命令，开启全局原生代理：

  1
  go env -w GO111MODULE=on
  2
  go env -w GOPROXY=https://goproxy.cn,direct
  

3. 配置 VScode 插件与工具链#

打开 VScode，进入扩展商店（Ctrl + Shift + X），搜索并安装 Go 官方核心插件：

• Go (由 Go Team at Google 开发)：这是官方发布的唯一核心插件，集成了代码高亮、智能补全、自动跳转等所有功能。

4. 运行代码测试#

现代 Go 语言全面采用 Go Modules 模式来管理代码，不需要把代码写在传统的 GOPATH/src 目录下了，你可以在电脑的任意英文目录下新建项目。

• 初始化项目：
  1. 新建一个英文名称的文件夹（如 hello_go），右键选择“通过Code打开”。
  2. 打开 VScode 集成终端，运行以下命令初始化模块名：

     1
     go mod init hello_go
     

  3. 此时目录下会自动生成一个 go.mod 文件，用来记录依赖。
• 编写代码：
  1. 新建一个名为 main.go 的文件，输入以下标准测试代码：

1
package main
2

3
import "fmt"
4

5
func main() {
6
  fmt.Println("Hello, World!")
7
  fmt.Println("你好，Go 语言！")
8
}

• 运行程序：
  1. 直接在 VScode 终端中输入以下命令即可直接运行，无需手动编译：

     1
     go run main.go
     

5. 调整与优化：一键 F5 启动调试#

Go 插件原生完美支持 VScode 的 F5 快捷键。由于我们刚才在第 3 步中安装了 dlv 调试器，配置一键启动非常简单。

TIP

在项目根目录下手动创建 .vscode 文件夹，并在其中新建 launch.json 文件。

• 配置 launch.json：将以下标准的 Go 调试配置粘贴进去并保存：

1
{
2
    "version": "0.2.0",
3
    "configurations": [
4
        {
5
            "name": "F5 调试 Go 程序",
6
            "type": "go",
7
            "request": "launch",
8
            "mode": "auto",
9
            "program": "${fileDirname}"
10
        }
11
    ]
12
}

优化说明：这里的 "program": "${fileDirname}" 非常智能，它会自动寻找并编译你当前打开的 .go 文件所在的整个目录。保存后，直接停留在 main.go 页面按下 F5 键，就能实现一键可视化调试与断点捕捉。

6. 提示#

1. Go 语言对于大括号的换行有着极其严格的编译器级别限制。例如，func main() 的左大括号 { 必须和函数名在同一行，如果另起一行换行写，编译时会直接强制报错。
2. 保存文件时，VScode 的 Go 插件会自动调用 goimports 帮你对齐格式并自动清理掉未使用的 import 库，属于正常现象，无需惊慌^-^。