long-agent/user-system

Fork 0

Files

long-agent bbeeb63dfa docs: project docs, scripts, deployment configs, and evidence

2026-04-02 11:22:17 +08:00

5.1 KiB

Raw Blame History

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安装包（推荐）

双击下载的MSI文件（如 go1.23.6.windows-amd64.msi）
在安装向导中点击 "Next"
接受许可协议
选择安装路径（默认 C:\Go 即可）
点击 "Install" 开始安装
等待安装完成
点击 "Finish" 完成安装

方法2: ZIP压缩包

下载ZIP文件（如 go1.23.6.windows-amd64.zip）
解压到 C:\ 目录
会得到 C:\go 目录
手动配置环境变量（见下一步）

🔧 步骤3: 配置环境变量

自动配置（MSI安装包）

MSI安装包通常会自动配置以下环境变量：

GOROOT: Go安装目录（如 C:\Go）
GOPATH: Go工作目录（默认 %USERPROFILE%\go）
PATH: 添加 %GOROOT%\bin 和 %GOPATH%\bin

如果自动配置失败，手动配置：

手动配置

右键点击 "此电脑" → "属性"
点击 "高级系统设置"
点击 "环境变量"
在 "系统变量" 中操作：

添加 GOROOT

点击 "新建"
变量名: GOROOT
变量值: C:\Go（或您的实际安装路径）
点击 "确定"

添加 GOPATH

点击 "新建"
变量名: GOPATH
变量值: %USERPROFILE%\go
点击 "确定"

编辑 PATH

找到 "Path" 变量
点击 "编辑"
点击 "新建"
添加: %GOROOT%\bin
再次点击 "新建"
添加: %GOPATH%\bin
点击 "确定" 保存

✅ 步骤4: 验证安装

重启命令行

重要: 必须重新打开PowerShell或命令提示符，环境变量才能生效！

检查Go版本

打开新的PowerShell窗口，运行：

go version

预期输出:

go version go1.23.6 windows/amd64

检查Go环境

go env

预期输出: 显示完整的Go环境配置

验证关键路径

# 检查GOROOT
$env:GOROOT

# 检查GOPATH
$env:GOPATH

# 检查PATH是否包含Go
$env:PATH -split ';' | Select-String "go"

🧪 步骤5: 测试Go

创建测试程序

# 创建临时目录
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' 不是内部或外部命令

解决方案:

检查Go是否安装成功
```
Test-Path C:\Go\bin\go.exe
```

检查环境变量

$env:PATH -split ';' | Select-String "Go"

如果PATH中没有Go，重新配置环境变量
重启命令行窗口

问题2: Go版本太旧

检查:

go version

如果版本 < 1.23，需要重新安装新版本。

问题3: 权限问题

如果安装时提示权限不足：

以管理员身份运行MSI安装包
右键点击MSI文件 → "以管理员身份运行"

问题4: PATH不生效

解决方案:

完全关闭所有命令行窗口
重新打开PowerShell
运行:
```
refreshenv
```
或者注销后重新登录

📝 安装后配置

配置Go模块代理（中国用户推荐）

# 设置Go模块代理（加速下载）
go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=off

验证代理设置

go env GOPROXY

预期输出: https://goproxy.cn,direct

🎯 下一步

安装完成后，请继续执行：

1. 验证项目编译

cd D:\project
go mod verify
go build ./cmd/server

2. 运行测试

go test ./... -v

3. 启动项目

go run cmd/server/main.go

4. 测试API

# 健康检查
Invoke-RestMethod http://localhost:8080/health

✅ 安装检查清单

完成Go安装后，请确认：

下载并安装了Go 1.23+
环境变量已配置（GOROOT, GOPATH, PATH）
重启了命令行窗口
go version 命令正常工作
go env 命令正常工作
测试程序运行成功
（可选）配置了Go模块代理

📞 遇到问题？

如果遇到安装问题：

查看官方文档: https://golang.org/doc/install
检查系统要求: Windows 7 或更高版本
检查磁盘空间: 至少 500MB 可用空间
检查权限: 确保有管理员权限

🎉 安装完成

完成以上步骤后，Go环境就安装完成了！

请告诉我"Go安装完成"，我将继续执行：

验证项目编译
运行测试
完成所有功能
确认迁移完成后删除C盘文件

安装预计时间: 10-20分钟

5.1 KiB Raw Blame History Unescape Escape