要成功启动gin web服务，必须正确配置goroot和gopath：先卸载旧版go并重启终端，再下载对应系统安装包，严格设置goroot指向go根目录、gopath指向工作区，并将二者bin路径加入path，最后通过go version和go env验证。
要在本地启动一个 Gin Web 服务，必须先让 Go 编译器能被系统识别、能定位标准库、能管理你写的代码——这三件事全靠 GOROOT 和 GOPATH 的精准指向来支撑，错一个路径，go run 就会报“command not found”或“cannot find package”，连 hello world 都跑不起来。
确认系统未残留旧版 Go 并卸载
打开终端（Windows 用 PowerShell 或 CMD，macOS/Linux 用 Terminal），执行：
where go（Windows）或 which go（macOS/Linux）。如果返回路径如 C:\Go\bin\go.exe 或 /usr/local/go/bin/go，说明已有安装，需先卸载。
Windows：控制面板 → 卸载程序 → 找到 “Go” → 卸载；
macOS：sudo rm -rf /usr/local/go；
Linux：sudo rm -rf /usr/local/go。
【关键前提】卸载后务必重启终端，否则旧 PATH 仍生效，后续验证会误判成功。
下载并安装 Go 二进制包
访问官方下载页 https://go.dev/dl/，根据系统选择对应安装包：
• Windows：选 go1.24.4.windows-amd64.msi（Intel/AMD）或 go1.24.4.windows-arm64.msi（M1/M2 Mac 用 Windows on ARM）；
• macOS：选 go1.24.4.darwin-arm64.pkg（Apple Silicon）或 go1.24.4.darwin-amd64.pkg（Intel）；
• Linux：选 go1.24.4.linux-amd64.tar.gz 或 go1.24.4.linux-arm64.tar.gz。
Windows/macOS 双击安装包按向导完成；Linux 执行：
sudo rm -rf /usr/local/go && sudo tar -C /usr/local -xzf go1.24.4.linux-amd64.tar.gz。
配置 GOROOT 环境变量
GOROOT 必须严格指向 Go 安装根目录，不能带 bin 子目录，也不能指向 GOPATH。
Windows（系统属性 → 高级 → 环境变量 → 系统变量 → 新建）：
变量名：GOROOT，变量值：C:\Go（MSI 默认路径）或你自定义的解压路径如 D:\go_down\go1.24.4。
macOS/Linux（编辑 ~/.zshrc 或 ~/.bash_profile）：
echo 'export GOROOT=/usr/local/go' >> ~/.zshrc && source ~/.zshrc。
【易错点】GOROOT 错配成 GOPATH 路径会导致 go install 失败，且 go env 输出中 GOROOT 显示为空或错误路径。
验证 GOROOT 是否生效
新开一个终端窗口，执行：
go env GOROOT。
正确输出应为绝对路径，例如：
/usr/local/go（macOS/Linux）或 C:\Go（Windows）。
若报错 “command not found: go”，说明 PATH 未包含 $GOROOT/bin；若输出为空或路径不存在，说明 GOROOT 变量未写对或未生效。
设置 GOPATH 并加入 PATH
GOPATH 是你写代码、存依赖、放编译产物的私人工作区，必须与 GOROOT 分离，且不能是系统盘根目录（如 C:\ 或 /home）。
第一步：创建 GOPATH 目录
Windows：mkdir D:\go_work；
macOS/Linux：mkdir -p ~/code/go。
第二步：配置 GOPATH 变量
Windows：新建系统变量 GOPATH = D:\go_work；
macOS/Linux：echo 'export GOPATH=$HOME/code/go' >> ~/.zshrc && source ~/.zshrc。
第三步：将 $GOPATH/bin 加入 PATH
Windows：在 PATH 变量末尾追加 ;%GOPATH%\bin；
macOS/Linux：echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.zshrc && source ~/.zshrc。
这一步做完，你才能用 go install 安装的工具（比如 fresh 热重载），否则命令始终提示 not found。
最终验证：go version + go env 全通过
执行以下两条命令，必须全部成功：
① go version → 输出类似 go version go1.24.4 darwin/arm64；
② go env GOPATH GOROOT GOBIN → 三行分别输出你设定的路径，其中 GOBIN 应自动为 $GOPATH/bin。
若其中任一命令失败，退回前几步检查变量名拼写、路径斜杠方向（Windows 用 \，macOS/Linux 用 /）、是否漏了 source 或重启终端。
