docs: project docs, scripts, deployment configs, and evidence
This commit is contained in:
135
docs/guides/GO_TROUBLESHOOTING.md
Normal file
135
docs/guides/GO_TROUBLESHOOTING.md
Normal file
@@ -0,0 +1,135 @@
|
||||
# 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` 验证!**
|
||||
|
||||
验证成功后告诉我,我将继续后续工作。
|
||||
Reference in New Issue
Block a user