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

运行命令：

go version

预期输出:

go version go1.26.1 windows/amd64

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

步骤4: 验证环境变量

go env

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

---

🔧 如果仍然失败

方法1: 手动添加PATH

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

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

& "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:

@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

运行:

verify_go.bat

---

💡 提示

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

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

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