g多版本管理工具

g 工具在 CMD 下完整的安装和使用指南。

安装前准备

为了避免路径冲突，建议先卸载系统上原有的 Go 环境。

手动安装与配置步骤 (CMD)

1. 下载文件
   从 g 工具的 GitHub Releases 页面 下载最新的 Windows 版本压缩包，例如 g1.7.0.windows-amd64.zip。

2. 解压并放置文件
   在 D 盘新建一个文件夹（如 D:\g）来统一管理。将压缩包中的 g.exe 解压到 D:\g 目录下。

3. 配置系统环境变量
   这是最关键的一步，需要通过 Windows 的图形界面操作：

   • 打开“系统属性” -> “高级” -> “环境变量”。
   • 在“系统变量”或“用户变量”中，新建或编辑以下变量：
     • G_HOME：值为 D:\g（你放置 g.exe 的根目录）。
     • GOROOT：值为 %G_HOME%\go（g 工具将通过软链接管理当前 Go 版本的位置）。
     • GOBIN：值为 %GOROOT%\bin。
     • G_MIRROR：值为 https://golang.google.cn/dl/（国内镜像，可加速下载）。
     • （可选）G_EXPERIMENTAL：值为 true。开启后可自定义安装目录，否则 g 会使用默认的 C:\Users\你的用户名\.g 目录。
   • 在系统变量 Path 中，新建并添加以下两条路径：
     • D:\g（这是 g.exe 所在目录，让你能在 CMD 中直接运行 g 命令）。
     • %GOBIN%（这是 Go 程序所在目录，让你能在 CMD 中直接运行 go 命令）。

4. 验证安装
   配置完成后，务必重新启动 CMD 以使所有环境变量生效。然后在新的 CMD 窗口中执行以下命令进行验证：

   g -v

   如果显示版本信息（如 g version 1.7.0），则说明 g 工具安装成功。

   go version

   此时可能提示找不到命令，这很正常，因为还没安装任何 Go 版本。

常用命令

常见问题排查

• “g 不是内部或外部命令”
  这表示环境变量 Path 没有正确配置。请检查 Path 中是否包含了 g.exe 所在的目录（例如 D:\g），并确保配置后重启了 CMD。

• “go 不是内部或外部命令”
  表示 Path 中没有包含 Go 的可执行文件路径。通常是因为还未安装任何 Go 版本，或 Path 变量中的 %GOBIN% 未正确展开。可以先执行 g install <version> 安装一个版本，再执行 g use <version> 切换，最后重启 CMD。

• 安装或切换版本失败
  这通常是因为 CMD 没有管理员权限。g 在安装和切换版本时需要创建软链接，请右键点击 CMD 图标，选择“以管理员身份运行”。

• 安装go版本失败

  D:\install>g install 1.26.1
  [g] Url "https://golang.google.cn/dl/" is unreachable ==> Get "https://golang.google.cn/dl/": dial tcp 198.18.191.93:443: connectex: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.

  设置多个镜像地址

  G_MIRROR=official|https://golang.google.cn/dl/,https://mirrors.aliyun.com/golang/,https://mirrors.nju.edu.cn/golang/,https://mirrors.hust.edu.cn/golang/,https://mirrors.ustc.edu.cn/golang/

CMD vs. PowerShell

虽然 CMD 完全可用，但 g 工具在 PowerShell 中的配置和使用体验会更加现代化和便捷。下表是两者的简单对比：

所以，如果你习惯在 CMD 下工作，完全可以按上述步骤使用。但如果追求更便捷的配置，PowerShell 会是一个更省心的选择。