一、安装 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
,应显示欢迎消息。