g，Go的多版本管理工具

简介

g 是管理 go 版本的工具，可以简化 go 的版本管理。

安装

自动安装

Linux/MacOS

适用于 bash、zsh

1
2


# 建议安装前清空`GOROOT`、`GOBIN`等环境变量
curl -sSL https://raw.githubusercontent.com/voidint/g/master/install.sh | bash

1

echo "unalias g" >> ~/.bashrc # 可选。若其他程序（如'git'）使用了'g'作为别名。

1

source "$HOME/.g/env"

Windows

目前版本 1.7.0 经过测试有问题，请查看手动安装部分

适用于 pwsh

1

iwr https://raw.githubusercontent.com/voidint/g/master/install.ps1 -useb | iex

手动安装

Linux/macOS

1
2


mkdir -p ~/.g \
mkdir -p ~/.g/bin

下载 release 的二进制压缩包，并解压至 g 家目录下的 bin 子目录中（即~/.g/bin目录）

1
2
3


wget https://github.com/voidint/g/releases/download/v1.7.0/g1.7.0.linux-amd64.tar.gz

tar -zxvf g1.7.0.linux-amd64.tar.gz -C ~/.g/bin

将所需的环境变量写入~/.g/env文件

1
2
3
4
5
6
7


cat >~/.g/env <<'EOF'
#!/bin/sh
# g shell setup
export GOROOT="${HOME}/.g/go"
export PATH="${HOME}/.g/bin:${GOROOT}/bin:$PATH"
export G_MIRROR=https://golang.google.cn/dl/
EOF

将~/.g/env导入到 shell 环境配置文件（如~/.bashrc、~/.zshrc…）

1
2
3
4
5
6


cat >>~/.bashrc <<'EOF'
# g shell setup
if [ -f "${HOME}/.g/env" ]; then
    . "${HOME}/.g/env"
fi
EOF

刷新环境变量

1

source ~/.bashrc # 或source ~/.zshrc

Windows

1

%USERPROFILE%/.g/bin

下载 g1.7.0.windows-amd64.zip
解压，放到%USERPROFILE%/.g/bin目录下
将 %USERPROFILE%/.g/bin添加到PATH环境变量

默认二进制文件名是 g.exe, 如果你已经用 g 这个命令已经用作为 git 的缩写，那么你可以把 g.exe 改为其他名字，如 gvm.exe

除此之外，还需要配置 GOROOT 环境变量，表示 Go 的安装路径

通过 g 安装的 go 安装路径为

1

%USERPROFILE%/.g/go

基本用法

查询当前可供安装的 go 版本

1

g lsr

查询当前可供安装的stable状态的 go 版本

1

g ls-remote stable

安装指定 go 版本1.22.4

1

g install 1.22.4

查询已安装的 go 版本

1

g ls

使用已安装的 go 版本

1

g use 1.19.10

卸载一个已安装的 go 版本

1

g uninstall 1.19.10

清空 go 安装包文件缓存

1

g clean

查看 g 版本信息

1

g version

更新 g 软件本身

1

g self update

卸载 g 软件本身

1

g self uninstall

环境变量

环境变量G_MIRROR有什么作用？

由于中国大陆无法自由访问 Golang 官网，导致查询及下载 go 版本都变得困难，因此可以通过该环境变量指定一个或多个镜像站点（多个镜像站点之间使用英文逗号分隔），g 将从该站点查询、下载可用的 go 版本。已知的可用镜像站点如下：

Go 官方镜像站：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/

环境变量G_EXPERIMENTAL有什么作用？

当该环境变量的值为true时，将开启所有的实验特性。

环境变量G_HOME有什么作用？

按照惯例，g 默认会将~/.g目录作为其家目录。若想自定义家目录（Windows 用户需求强烈），可使用该环境变量切换到其他家目录。由于该特性还属于实验特性，需要先开启实验特性开关G_EXPERIMENTAL=true才能生效。特别注意，该方案并不十分完美，因此才将其归类为实验特性，详见#18。

相似项目

gvm
goenv