Go 语言环境安装指南(Windows 版)
以下是在 Windows 系统上安装 Go 语言环境的完整步骤:
准备工作
- 操作系统要求:Windows 7 或更高版本(推荐 Windows 10/11)
- 系统架构:64位(x86-64)或32位(x86)
- 磁盘空间:至少 500MB 可用空间
安装步骤
1. 下载安装包
访问 Go 官方下载页:
下载 Windows 安装包(根据系统选择):
- 64位系统:
go1.21.0.windows-amd64.msi
- 32位系统:
go1.21.0.windows-386.msi
2. 运行安装程序
- 双击下载的
.msi
文件 - 接受许可协议
- 重要设置 :
- 安装路径:保持默认
C:\Go\
(除非有特殊需求) - 勾选 Add Go to PATH(自动配置环境变量)
- 安装路径:保持默认
- 点击 Install 开始安装
3. 验证安装
-
打开命令提示符(
Win + R
→ 输入cmd
) -
执行以下命令:
go version
成功显示(版本号可能不同):
go version go1.21.0 windows/amd64
环境变量配置
安装程序会自动设置以下变量:
变量名 | 默认值 | 作用 |
---|---|---|
GOROOT | C:\Go | Go 安装根目录 |
Path | 添加 %GOROOT%\bin |
Go 命令执行路径 |
GOPATH | %USERPROFILE%\go | 工作目录(建议修改) |
推荐手动配置:
-
添加用户变量(建议):
GOPATH = D:\GoWorkspace # 自定义工作区路径
-
创建工作区目录(非必须但推荐):
D:\GoWorkspace\ ├── bin/ # 可执行文件 ├── pkg/ # 编译包文件 └── src/ # 项目源代码
开发工具推荐
-
VS Code(推荐首选):
- 安装 Go 扩展:
Go Team at Google
- 支持自动补全、调试、重构等
- 安装 Go 扩展:
-
Goland(JetBrains 产品):
- 专业级 Go IDE(付费,有试用版)
-
Sublime Text/Vim:
- 轻量级编辑器 + Go 插件
测试第一个 Go 程序
-
创建
hello.go
文件:package main import "fmt" func main() { fmt.Println("Hello, World!") }
-
编译运行:
# 方式1:直接运行 go run hello.go # 方式2:编译后运行 go build hello.go .\hello.exe
输出结果:
Hello, World!
国内用户特殊配置
解决模块下载慢的问题:
-
设置 Go 模块代理:
go env -w GO111MODULE=on go env -w GOPROXY=https://goproxy.cn,direct
-
可选镜像:
https://goproxy.io https://mirrors.aliyun.com/goproxy/
常见问题解决
-
go: command not found
- 检查环境变量
Path
是否包含C:\Go\bin
- 重启命令提示符或计算机
- 检查环境变量
-
权限问题
- 以管理员身份运行命令提示符
- 检查安装目录权限(右键属性 → 安全)
-
版本冲突
- 卸载旧版:控制面板 → 程序和功能 → 删除旧版 Go
- 清理残留:删除
C:\Go\
和旧环境变量
-
开发工具识别问题
- 在 VS Code 中按
Ctrl+Shift+P
输入>Go: Install/Update Tools
- 全选所有工具点击确定安装
- 在 VS Code 中按
卸载 Go
- 控制面板 → 程序和功能 → 卸载 Go
- 手动删除残留:
- 安装目录:
C:\Go\
- 环境变量:删除
GOROOT
和Path
中的相关条目 - 工作区:删除自定义的
GOPATH
目录
- 安装目录:
安装完成!
现在已拥有完整的 Go 开发环境,可以开始:
- 使用
go get
安装第三方包 - 开发多文件项目
- 使用
go mod
进行依赖管理 - 编译跨平台二进制文件