docs: project docs, scripts, deployment configs, and evidence

docs/guides/GO_INSTALLATION_GUIDE.md

@@ -0,0 +1,297 @@
+# 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分钟