一、安装 Go
下载 Go 安装包
- 访问 Go 官方网站:
https://golang.org/dl/。 - 选择适合 Windows 的最新稳定版本。
- 下载
.msi安装文件,例如go1.21.7.windows-amd64.msi。
- 访问 Go 官方网站:
运行安装程序
- 双击下载的
.msi文件,按照提示安装。 - 默认安装路径为:
C:\Program Files\Go(建议保持默认)。 - 安装完成后,Go 的二进制文件会位于
C:\Program Files\Go\bin。
- 双击下载的
验证安装
打开命令提示符(按
Win + R,输入cmd,回车)。输入以下命令检查版本:
go version如果显示类似
go version go1.21.7 windows/amd64,说明安装成功。
二、配置环境变量
Windows 上需要配置环境变量,以便在任何目录下都能使用 go 命令。
检查默认环境变量
Go 的安装程序通常会自动将
C:\Program Files\Go\bin添加到系统 PATH 中。在命令提示符中运行
go env检查:GOEXE应为.exe。GOPATH默认是%USERPROFILE%\go(如C:\Users\你的用户名\go)。
手动配置(若未自动添加)
右键“此电脑” > “属性” > “高级系统设置” > “环境变量”。
在“系统变量”下的
Path中,点击“编辑”,添加:C:\Program Files\Go\bin点击“确定”保存。
设置 GOPATH(可选)
GOPATH是 Go 工作目录,用于存放源码、依赖和编译结果。默认值为
%USERPROFILE%\go,若想自定义:在“用户变量”中新增变量:
- 变量名:
GOPATH - 变量值:
D:\GoProjects。
- 变量名:
验证:重启命令提示符,运行
go env GOPATH,应显示你设置的路径。
验证环境变量
重启命令提示符,运行:
go env检查
GOROOT(Go 安装路径,如C:\Program Files\Go)和GOPATH是否正确。
三、安装必备工具
安装 Git
- Go 依赖 Git 来下载模块。
- 下载地址:
https://git-scm.com/download/win。 - 安装后,确保
git --version可在命令行运行。
代码编辑器
推荐使用 Visual Studio Code(VS Code):
下载:
https://code.visualstudio.com/。安装 Go 扩展:
- 打开 VS Code,按
Ctrl + Shift + X打开扩展市场。 - 搜索
Go(由 Go Team 开发),点击安装。 - 安装后,按
Ctrl + Shift + P,输入Go: Install/Update Tools,选择并安装所有推荐工具(如gopls)。
- 打开 VS Code,按
终端(可选)
默认使用
cmd,但推荐安装更强大的终端:- Windows Terminal:微软商店下载。
- PowerShell:Windows 自带。
四、测试 Go 环境
创建第一个 Go 项目
创建工作目录:
mkdir D:\GoProjects\hello cd D:\GoProjects\hello初始化模块(Go 1.11+ 使用模块化管理):
go mod init hello
编写代码
创建
main.go文件:package main import "fmt" func main() { fmt.Println("Hello, Go on Windows!") }保存文件。
运行程序
在命令行运行:
go run main.go输出:
Hello, Go on Windows!
编译程序
编译为可执行文件:
go build生成
hello.exe,双击运行或在命令行输入hello执行。
五、常见问题与解决
命令
go未找到- 检查
Path是否包含C:\Program Files\Go\bin。 - 重启命令提示符或电脑。
- 检查
模块下载失败
设置代理(若在中国大陆):
go env -w GOPROXY=https://goproxy.cn,direct确保 Git 已安装。
VS Code 提示缺少工具
- 运行
go mod tidy下载依赖。 - 在 VS Code 中重新安装 Go 工具(
Go: Install/Update Tools)。
- 运行
六、进阶配置(可选)
设置 GOBIN
默认编译的可执行文件放在
GOPATH/bin,可自定义:go env -w GOBIN=D:\GoProjects\bin添加
D:\GoProjects\bin到Path。
启用 Go Modules
- Go 1.11+ 默认支持模块化,无需 GOPATH 即可开发。
- 每个项目运行
go mod init <module-name>初始化。
安装常用工具
- 格式化:
go fmt(内置)。 - 静态分析:
go install golang.org/x/lint/golint@latest。 - 依赖管理:
go get。
- 格式化:
七、开发环境验证
创建一个简单 HTTP 服务器测试完整性:
package main import ( "fmt" "net/http" ) func main() { http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) { fmt.Fprintf(w, "Welcome to Go on Windows!") }) fmt.Println("Server running at http://localhost:8080") http.ListenAndServe(":8080", nil) }运行:
go run main.go。打开浏览器访问
http://localhost:8080,应显示欢迎消息。