Go 环境 Windows 搭建教程
📋 目录
🚀 前言
Go（也称为 Golang）是 Google 开发的一种静态强类型、编译型语言。本教程将指导您在 Windows 系统上完整搭建 Go 开发环境。
📥 下载与安装 Go
下载地址
- Go 官网：https://golang.org/dl/
- Go 官方镜像站（推荐）：https://golang.google.cn/dl/
- 最新稳定版下载链接：https://go.dev/dl/go1.24.6.windows-amd64.msi
安装步骤
下载安装包
- 访问上述链接，下载适合您系统的安装包
- Windows 64位系统选择
go1.24.6.windows-amd64.msi
运行安装程序
- 双击下载的
.msi文件 - 按照安装向导提示，一路"下一步"即可
- 默认安装路径：
C:\Program Files\Go
- 双击下载的
系统环境变量配置
- 安装程序会自动配置环境变量
GOROOT：Go 安装目录PATH：添加%GOROOT%\bin
验证安装
打开命令提示符或 PowerShell，执行以下命令：
# 查看 Go 版本
go version
预期输出：
go version go1.24.6 windows/amd64
# 查看 Go 环境配置
go env
部分重要输出示例：
set GOARCH=amd64
set GOCACHE=C:\Users\Ripen-life\AppData\Local\go-build
set GOENV=C:\Users\Ripen-life\AppData\Roaming\go\env
set GOEXE=.exe
set GOHOSTARCH=amd64
set GOHOSTOS=windows
set GOMODCACHE=C:\Users\Ripen-life\go\pkg\mod
set GOOS=windows
set GOPATH=C:\Users\Ripen-life\go
set GOPROXY=https://proxy.golang.org,direct
set GOROOT=C:\Program Files\Go
set GOTOOLDIR=C:\Program Files\Go\pkg\tool\windows_amd64
set GOVCS=
set GOVERSION=go1.24.6
🔧 配置开发环境
VSCode 安装与配置
下载 VSCode
- 访问：https://code.visualstudio.com/docs/?dv=win64user
- 下载并安装 Visual Studio Code
中文汉化（可选）
- 打开 VSCode
- 按
Ctrl+Shift+P打开命令面板 - 输入
Configure Display Language - 选择
中文(简体) - 重启 VSCode
Go 插件安装
安装 Go 扩展
- 打开 VSCode
- 点击侧边栏的扩展图标（或按
Ctrl+Shift+X） - 搜索 “Go”
- 安装由 Google 开发的 “Go” 扩展
安装 Go 工具
- 打开任意
.go文件 - VSCode 会提示安装 Go 工具
- 点击 “Install All” 安装所有推荐工具
- 打开任意
插件安装问题解决方案
如果遇到插件或工具安装失败，可以尝试以下方法：
- 🌐 科学上网：使用 VPN 或代理
- 📱 手机热点：切换网络环境
- 🔄 多次尝试：网络问题可能是临时的
- 🔧 手动安装：使用以下命令手动安装工具
# 设置代理（如有需要）
go env -w GOPROXY=https://goproxy.cn,direct
# 手动安装常用工具
go install -v golang.org/x/tools/gopls@latest
go install -v github.com/ramya-rao-a/go-outline@latest
go install -v github.com/cweill/gotests/gotests@latest
go install -v github.com/fatih/gomodifytags@latest
go install -v github.com/josharian/impl@latest
go install -v github.com/haya14busa/goplay/cmd/goplay@latest
go install -v github.com/go-delve/delve/cmd/dlv@latest
📝 Go 项目初始化
创建项目目录
# 创建项目目录
mkdir D:\Projects\Go\HelloWorld
cd D:\Projects\Go\HelloWorld
初始化 Go 模块
# 初始化 Go 模块
go mod init HelloWorld
输出示例：
go: creating new go.mod: module HelloWorld
go: to add module requirements and sums:
go mod tidy
编写第一个 Go 程序
创建 main.go 文件：
package main
import "fmt"
func main() {
fmt.Println("Hello, World!")
fmt.Println("Go 环境搭建成功！")
}
运行程序
# 运行 Go 程序
go run main.go
预期输出：
Hello, World!
Go 环境搭建成功！
🎯 常用命令
| 命令 | 功能 | 示例 |
|---|---|---|
go version |
查看 Go 版本 | go version |
go env |
查看环境变量 | go env GOPATH |
go mod init |
初始化模块 | go mod init myproject |
go mod tidy |
整理依赖 | go mod tidy |
go get |
下载依赖包 | go get github.com/gin-gonic/gin |
go run |
运行程序 | go run main.go |
go build |
编译程序 | go build |
go install |
安装程序 | go install |
go fmt |
格式化代码 | go fmt ./... |
go test |
运行测试 | go test ./... |
❓ 常见问题
Q1: 提示 “go: command not found”
A: 检查环境变量配置，确保 Go 的 bin 目录已添加到 PATH。
Q2: 模块下载缓慢或失败
A: 设置国内代理：
go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=sum.golang.google.cn
Q3: VSCode 中 Go 插件无法正常工作
A:
- 确保已安装 Go 工具：
Ctrl+Shift+P→Go: Install/Update Tools - 重启 VSCode
- 检查 Go 路径设置
Q4: 编译时找不到包
A:
- 确保在项目根目录（有 go.mod 文件的目录）
- 运行
go mod tidy更新依赖 - 检查 import 路径是否正确
📚 参考资源
🎉 恭喜！您已成功搭建 Go 开发环境，开始您的 Go 编程之旅吧！