298 lines
5.1 KiB
Markdown
298 lines
5.1 KiB
Markdown
# Go环境安装指南
|
||
|
||
## 📥 步骤1: 下载Go
|
||
|
||
访问Go官方网站: https://golang.org/dl/
|
||
|
||
### Windows版本选择
|
||
|
||
根据您的系统选择对应的版本：
|
||
|
||
| 系统架构 | 下载链接 |
|
||
|---------|---------|
|
||
| 64位Windows（推荐） | https://go.dev/dl/go1.23.6.windows-amd64.msi |
|
||
| 32位Windows | https://go.dev/dl/go1.23.6.windows-386.msi |
|
||
|
||
**推荐版本**: Go 1.23.6 或更高版本
|
||
|
||
---
|
||
|
||
## 🚀 步骤2: 安装Go
|
||
|
||
### 方法1: MSI安装包（推荐）
|
||
|
||
1. 双击下载的MSI文件（如 `go1.23.6.windows-amd64.msi`）
|
||
2. 在安装向导中点击 "Next"
|
||
3. 接受许可协议
|
||
4. 选择安装路径（默认 `C:\Go` 即可）
|
||
5. 点击 "Install" 开始安装
|
||
6. 等待安装完成
|
||
7. 点击 "Finish" 完成安装
|
||
|
||
### 方法2: ZIP压缩包
|
||
|
||
1. 下载ZIP文件（如 `go1.23.6.windows-amd64.zip`）
|
||
2. 解压到 `C:\` 目录
|
||
3. 会得到 `C:\go` 目录
|
||
4. 手动配置环境变量（见下一步）
|
||
|
||
---
|
||
|
||
## 🔧 步骤3: 配置环境变量
|
||
|
||
### 自动配置（MSI安装包）
|
||
|
||
MSI安装包通常会自动配置以下环境变量：
|
||
- `GOROOT`: Go安装目录（如 `C:\Go`）
|
||
- `GOPATH`: Go工作目录（默认 `%USERPROFILE%\go`）
|
||
- `PATH`: 添加 `%GOROOT%\bin` 和 `%GOPATH%\bin`
|
||
|
||
**如果自动配置失败，手动配置：**
|
||
|
||
### 手动配置
|
||
|
||
1. 右键点击 "此电脑" → "属性"
|
||
2. 点击 "高级系统设置"
|
||
3. 点击 "环境变量"
|
||
4. 在 "系统变量" 中操作：
|
||
|
||
#### 添加 GOROOT
|
||
|
||
1. 点击 "新建"
|
||
2. 变量名: `GOROOT`
|
||
3. 变量值: `C:\Go`（或您的实际安装路径）
|
||
4. 点击 "确定"
|
||
|
||
#### 添加 GOPATH
|
||
|
||
1. 点击 "新建"
|
||
2. 变量名: `GOPATH`
|
||
3. 变量值: `%USERPROFILE%\go`
|
||
4. 点击 "确定"
|
||
|
||
#### 编辑 PATH
|
||
|
||
1. 找到 "Path" 变量
|
||
2. 点击 "编辑"
|
||
3. 点击 "新建"
|
||
4. 添加: `%GOROOT%\bin`
|
||
5. 再次点击 "新建"
|
||
6. 添加: `%GOPATH%\bin`
|
||
7. 点击 "确定" 保存
|
||
|
||
---
|
||
|
||
## ✅ 步骤4: 验证安装
|
||
|
||
### 重启命令行
|
||
|
||
**重要**: 必须重新打开PowerShell或命令提示符，环境变量才能生效！
|
||
|
||
### 检查Go版本
|
||
|
||
打开新的PowerShell窗口，运行：
|
||
|
||
```powershell
|
||
go version
|
||
```
|
||
|
||
**预期输出**:
|
||
```
|
||
go version go1.23.6 windows/amd64
|
||
```
|
||
|
||
### 检查Go环境
|
||
|
||
```powershell
|
||
go env
|
||
```
|
||
|
||
**预期输出**: 显示完整的Go环境配置
|
||
|
||
### 验证关键路径
|
||
|
||
```powershell
|
||
# 检查GOROOT
|
||
$env:GOROOT
|
||
|
||
# 检查GOPATH
|
||
$env:GOPATH
|
||
|
||
# 检查PATH是否包含Go
|
||
$env:PATH -split ';' | Select-String "go"
|
||
```
|
||
|
||
---
|
||
|
||
## 🧪 步骤5: 测试Go
|
||
|
||
### 创建测试程序
|
||
|
||
```powershell
|
||
# 创建临时目录
|
||
mkdir $env:USERPROFILE\test-go
|
||
cd $env:USERPROFILE\test-go
|
||
|
||
# 创建测试文件
|
||
@'
|
||
package main
|
||
|
||
import "fmt"
|
||
|
||
func main() {
|
||
fmt.Println("Hello, Go is installed correctly!")
|
||
}
|
||
'@ | Out-File -FilePath hello.go -Encoding utf8
|
||
|
||
# 运行测试程序
|
||
go run hello.go
|
||
```
|
||
|
||
**预期输出**:
|
||
```
|
||
Hello, Go is installed correctly!
|
||
```
|
||
|
||
---
|
||
|
||
## 🔍 故障排查
|
||
|
||
### 问题1: go命令找不到
|
||
|
||
**错误信息**:
|
||
```
|
||
'go' 不是内部或外部命令
|
||
```
|
||
|
||
**解决方案**:
|
||
1. 检查Go是否安装成功
|
||
```powershell
|
||
Test-Path C:\Go\bin\go.exe
|
||
```
|
||
2. 检查环境变量
|
||
```powershell
|
||
$env:PATH -split ';' | Select-String "Go"
|
||
```
|
||
3. 如果PATH中没有Go，重新配置环境变量
|
||
4. **重启命令行窗口**
|
||
|
||
### 问题2: Go版本太旧
|
||
|
||
**检查**:
|
||
```powershell
|
||
go version
|
||
```
|
||
|
||
如果版本 < 1.23，需要重新安装新版本。
|
||
|
||
### 问题3: 权限问题
|
||
|
||
如果安装时提示权限不足：
|
||
1. 以管理员身份运行MSI安装包
|
||
2. 右键点击MSI文件 → "以管理员身份运行"
|
||
|
||
### 问题4: PATH不生效
|
||
|
||
**解决方案**:
|
||
1. 完全关闭所有命令行窗口
|
||
2. 重新打开PowerShell
|
||
3. 运行:
|
||
```powershell
|
||
refreshenv
|
||
```
|
||
或者注销后重新登录
|
||
|
||
---
|
||
|
||
## 📝 安装后配置
|
||
|
||
### 配置Go模块代理（中国用户推荐）
|
||
|
||
```powershell
|
||
# 设置Go模块代理（加速下载）
|
||
go env -w GOPROXY=https://goproxy.cn,direct
|
||
go env -w GOSUMDB=off
|
||
```
|
||
|
||
### 验证代理设置
|
||
|
||
```powershell
|
||
go env GOPROXY
|
||
```
|
||
|
||
预期输出: `https://goproxy.cn,direct`
|
||
|
||
---
|
||
|
||
## 🎯 下一步
|
||
|
||
安装完成后，请继续执行：
|
||
|
||
### 1. 验证项目编译
|
||
|
||
```powershell
|
||
cd D:\project
|
||
go mod verify
|
||
go build ./cmd/server
|
||
```
|
||
|
||
### 2. 运行测试
|
||
|
||
```powershell
|
||
go test ./... -v
|
||
```
|
||
|
||
### 3. 启动项目
|
||
|
||
```powershell
|
||
go run cmd/server/main.go
|
||
```
|
||
|
||
### 4. 测试API
|
||
|
||
```powershell
|
||
# 健康检查
|
||
Invoke-RestMethod http://localhost:8080/health
|
||
```
|
||
|
||
---
|
||
|
||
## ✅ 安装检查清单
|
||
|
||
完成Go安装后，请确认：
|
||
|
||
- [ ] 下载并安装了Go 1.23+
|
||
- [ ] 环境变量已配置（GOROOT, GOPATH, PATH）
|
||
- [ ] 重启了命令行窗口
|
||
- [ ] `go version` 命令正常工作
|
||
- [ ] `go env` 命令正常工作
|
||
- [ ] 测试程序运行成功
|
||
- [ ] （可选）配置了Go模块代理
|
||
|
||
---
|
||
|
||
## 📞 遇到问题？
|
||
|
||
如果遇到安装问题：
|
||
|
||
1. **查看官方文档**: https://golang.org/doc/install
|
||
2. **检查系统要求**: Windows 7 或更高版本
|
||
3. **检查磁盘空间**: 至少 500MB 可用空间
|
||
4. **检查权限**: 确保有管理员权限
|
||
|
||
---
|
||
|
||
## 🎉 安装完成
|
||
|
||
完成以上步骤后，Go环境就安装完成了！
|
||
|
||
请告诉我"Go安装完成"，我将继续执行：
|
||
1. 验证项目编译
|
||
2. 运行测试
|
||
3. 完成所有功能
|
||
4. 确认迁移完成后删除C盘文件
|
||
|
||
---
|
||
|
||
**安装预计时间**: 10-20分钟
|