Go 版本管理工具 g 使用教程

Go 版本管理工具 g 使用教程

g Golang Version Manager 项目地址: https://gitcode.com/gh_mirrors/g5/g

1. 项目介绍

g 是一个开源的命令行工具，用于在 Linux、macOS 和 Windows 系统上方便地管理和切换多个版本的 Go 环境。它支持列出可用的 Go 版本、安装和卸载特定版本的 Go、自由切换已安装的版本、清除包文件缓存等功能。

2. 项目快速启动

安装

自动安装

Linux/macOS (bash/zsh)

在安装前，建议清除 GOROOT、GOBIN 等环境变量。

curl -sSL https://raw.githubusercontent.com/voidint/g/master/install.sh | bash

将以下内容添加到 ~/.bashrc 或 ~/.zshrc 文件中：

# g shell setup
if [ -f "$HOME/.g/env" ]; then
    . "$HOME/.g/env"
fi

然后，使环境变量生效：

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

Windows (pwsh)

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

手动安装

Linux/macOS

1. 创建一个目录用于存放 g（推荐：~/.g）。
2. 从 发布页面 下载二进制压缩文件，解压到 g 目录的 bin 子目录下（即 ~/.g/bin）。
3. 将必要的环境变量写入 ~/.g/env 文件。

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 等）
cat >> ~/.bashrc <<EOF
# g shell setup
if [ -f "${HOME}/.g/env" ]; then
    . "${HOME}/.g/env"
fi
EOF

# 使环境变量生效
source ~/.bashrc
# 或者
source ~/.zshrc

Windows PowerShell

1. 创建目录：

mkdir ~/.g/bin

2. 下载 Windows 版本的二进制压缩文件，并解压到 ~/.g/bin 目录。
3. 使用 code $PROFILE 命令打开默认的 PowerShell 配置文件。
4. 添加以下内容到 PowerShell 配置文件：

$env:GOROOT = "$HOME\.g\go"
$env:Path = -join (
    "$HOME\.g\bin;",
    "$env:GOROOT\bin;",
    $env:Path
)

5. 重新打开 PowerShell 终端，即可使用 g 或 gvm 命令。

使用

• 列出当前可用的稳定版本：

g ls-remote stable

• 安装特定版本的 Go：

g install 1.20.5

• 列出已安装的 Go 版本：

g ls

• 列出所有可用的 Go 版本：

g ls-remote

• 切换到另一个已安装的 Go 版本：

g use 1.19.10

• 卸载特定版本的 Go：

g uninstall 1.19.10

• 清除 Go 安装包的缓存：

g clean

• 查看当前 g 的版本信息：

g version

• 更新 g 本身：

g self update

• 卸载 g：

g self uninstall

3. 应用案例和最佳实践

• 使用 g 管理多个 Go 版本，方便在不同项目间切换。
• 在持续集成/持续部署 (CI/CD) 流程中使用 g 来确保使用正确的 Go 版本。
• 利用 g 的自我更新功能保持工具的最新状态。

4. 典型生态项目

• gvm：另一个流行的 Go 版本管理工具。
• govendor：Go 依赖管理工具。
• go-outline：用于 Go 代码的语法高亮和分析的工具。

g Golang Version Manager 项目地址: https://gitcode.com/gh_mirrors/g5/g