user-system/docs/guides/GO_TROUBLESHOOTING.md

# Go安装问题诊断

## 🔍 诊断结果

**Go 1.26.1 已安装** 到 `C:\Program Files\Go\`

**问题**: Go命令无法在当前执行环境中运行

**可能原因**:
1. 环境变量PATH未更新
2. 命令行窗口未重启
3. Go.exe文件权限问题

---

## ✅ 手动验证步骤

### 步骤1: 完全关闭所有命令行窗口

关闭所有：
- PowerShell窗口
- 命令提示符窗口
- VS Code终端
- 任何IDE的终端

### 步骤2: 重新打开PowerShell

按 `Win + X`，选择 "Windows PowerShell" 或 "Terminal"

### 步骤3: 验证Go

运行命令：

```powershell
go version
```

**预期输出**:
```
go version go1.26.1 windows/amd64
```

如果看到版本号，说明安装成功！

### 步骤4: 验证环境变量

```powershell
go env
```

应该显示完整的Go环境配置。

---

## 🔧 如果仍然失败

### 方法1: 手动添加PATH

1. 右键 "此电脑" → "属性"
2. "高级系统设置" → "环境变量"
3. 在 "系统变量" 中找到 "Path"
4. 点击 "编辑"
5. 点击 "新建"
6. 添加: `C:\Program Files\Go\bin`
7. 点击 "确定" 保存所有窗口

### 方法2: 临时使用完整路径

```powershell
& "C:\Program Files\Go\bin\go.exe" version
```

### 方法3: 使用新的PowerShell窗口

1. 按 `Win + R`
2. 输入 `powershell`
3. 按回车
4. 运行 `go version`

---

## ✅ 验证成功后

一旦 `go version` 命令正常工作，请告诉我：

**"Go验证成功"**

然后我将立即继续：

1. ✅ 验证项目编译
2. ✅ 运行项目测试
3. ✅ 完成所有功能实现
4. ✅ 确认迁移完成后删除C盘文件

---

## 🎯 快速验证脚本

创建新文件 `verify_go.bat`:

```batch
@echo off
echo Verifying Go installation...
echo.
"C:\Program Files\Go\bin\go.exe" version
echo.
if %errorlevel% == 0 (
    echo [SUCCESS] Go is working!
    echo.
    echo Please tell WorkBuddy: "Go验证成功"
) else (
    echo [ERROR] Go is not working
    echo.
    echo Please try:
    echo 1. Close all command windows
    echo 2. Open new PowerShell
    echo 3. Run: go version
)
pause
```

运行:
```batch
verify_go.bat
```

---

## 💡 提示

**如果 `go version` 在新的PowerShell窗口中正常工作**，说明安装成功，只是之前的命令行窗口需要刷新环境变量。

**请重新打开PowerShell窗口并运行 `go version` 验证！**

验证成功后告诉我，我将继续后续工作。