# 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分钟
