用 g 管理 Go 多版本，解放双手，丝滑的一批

“前端有 nvm，Ruby 有 rvm，Python 有 pyenv……
而 Go？
—— 以前：手动删 GOROOT、改 PATH、重启终端、祈祷生效 🙏
—— 现在：g use 1.25.0，回车，搞定。
像极了你对咖啡师说‘老样子，半糖去冰’——而世界，真的听懂了。”

---

🎯 一、为什么需要 g？—— 因为现实很骨感

想象以下场景 👇

场景	你的反应
老项目用 go1.19，新项目要 go1.25	🫠 手动改 GOROOT + source ~/.zshrc × 3
CI 报错：unknown field 'Minify' in struct literal	🤯 原来本地是 1.22，CI 是 1.20……（版本错乱 PTSD 发作）
同事：“你这代码在我机器跑不通”	🤨 go version → 他 1.18，你 1.23 —— 时代的眼泪

💡 真相：
Go 的兼容性虽好，但——

• 1.20 引入 context.WithTimeoutFunc
• 1.21 加了 slices、maps 新包
• 1.22 优化了 for-range 性能……
  你的代码，可能悄悄依赖了某个“未来版本”。

这时候，你需要一个环境分身术大师——g ✨
（全名就叫 g，极简主义的浪漫 🐧）

🔔 注意：
它不是 gvm（那个老牌工具已归档），
而是 voidint/g —— 轻量、跨平台、零依赖、中文文档友好！

---

🛠️ 二、安装 g：比泡面还快，比点外卖还稳

▶️ Linux / macOS

# 一键安装（脚本来自官方，放心食用 🍜）
curl -sSL https://raw.githubusercontent.com/voidint/g/master/install.sh | bash

# 然后把环境变量塞进 shell 配置
echo 'source "$HOME/.g/env"' >> ~/.bashrc  # 或 ~/.zshrc
source ~/.bashrc

✅ 效果：

• 创建 ~/.g/ 目录（你的 Go 版本“公寓楼”）
• ~/.g/bin/g 是管家本管
• ~/.g/env 是环境变量“入住协议”

---

▶️ Windows（PowerShell 用户看这里 👀）

# 一键安装（官方 PS 脚本）
iwr https://raw.githubusercontent.com/voidint/g/master/install.ps1 -useb | iex

# 然后加 PATH（脚本会提示，或手动）：
$env:GOROOT="$HOME\.g\go"
$env:Path = "$HOME\.g\bin;$env:GOROOT\bin;$env:Path"

💡 小技巧：
如果你用 g 当 git 别名（比如 alias g=git），
可以把 g.exe 改名成 gvm.exe —— 名字只是代号，功能才是王道 😎

---

🌟 三、g 的四大神技

1️⃣ 查：看看有哪些 Go 版本可用？

# 查所有远程版本（含 beta/rc）
$ g ls-remote
  1.18.10
  1.19.13
  1.20.14
  1.21.6
* 1.25.0  ← 带 * 是当前用的
  1.23rc1

# 只看稳定版（推荐！）
$ g ls-remote stable
  1.20.14
  1.21.6
  1.25.0

🍵 冷知识：
g 默认用 https://golang.google.cn/dl/ 镜像（国内快如闪电⚡），
也可自定义：export G_MIRROR=https://mirrors.aliyun.com/golang/

---

2️⃣ 装：一键下载指定版本

# 安装 Go 1.22.0（自动下载 + 校验 + 解压）
$ g install 1.22.0
Downloading 100% [===============] (128/128 MB, 15 MB/s)
Computing checksum with SHA256
Checksums matched
Now using go1.22.0

✅ 背后发生了什么？

• 下载 go1.22.0.darwin-arm64.tar.gz（自动适配系统）
• 校验 SHA256（防篡改）
• 解压到 ~/.g/go/1.22.0/
• 软链接 ~/.g/go → ~/.g/go/1.22.0（当前激活版本）

⚠️ ARM Mac 用户注意：
别装 1.15！Go 官方 1.16+ 才支持 Apple Silicon～
否则你会看到：[g] Installation package not found. —— 不是 bug，是历史局限 😅

---

3️⃣ 切：秒级切换 Go 版本（核心爽点！）

# 查已安装的版本
$ g ls
  1.20.14
  1.21.6
* 1.25.0   ← * 表示当前激活

# 切到 1.21.6
$ g use 1.21.6
go version go1.21.6 darwin/arm64  ← 瞬间生效！

# 再切回来
$ g use 1.22.0
go version go1.22.0 darwin/arm64

✅ 验证：

$ which go
/Users/you/.g/go/bin/go  ← 永远指向 ~/.g/go/bin/go

$ go version
go version go1.22.0 darwin/arm64

🎯 原理：
g 用软链接管理版本——
~/.g/go → ~/.g/versions/1.22.0
切换 = ln -sf ~/.g/versions/1.21.6 ~/.g/go —— 比改 PATH 快 100 倍！

---

4️⃣ 清：卸载不用的版本

# 卸载 1.20.14
$ g uninstall 1.20.14
Uninstalled go1.20.14

# 清下载缓存（.tar.gz 文件）
$ g clean
Remove go1.21.6.darwin-arm64.tar.gz
Remove go1.22.0.darwin-arm64.tar.gz

💡 空间党狂喜：
一个 Go 版本约 120MB，装 5 个就 600MB——
g clean 一键瘦身，C 盘：终于能喘口气了 💨

---

🧪 四、实战：模拟“多项目并行开发”现场

假设你同时维护：

项目	要求 Go 版本	依赖特性
legacy-api	≥1.19	无泛型
modern-web	≥1.23	用 slices 包
bleeding-edge	1.25rc1	试用新语法

操作流程：

# 1. 安装所需版本
$ g install 1.19.13 1.23.6 1.25rc1

# 2. 进 legacy-api 目录 → 切 1.19
$ cd legacy-api
$ g use 1.19.13
$ go run main.go  # ✅ 跑得飞起

# 3. 进 modern-web → 切 1.21
$ cd ../modern-web
$ g use 1.23.6
$ go test ./...   # ✅ slices.Sort 正常工作

# 4. 进 bleeding-edge → 切 1.23rc1
$ cd ../bleeding-edge
$ g use 1.25rc1
$ go build       # ✅ 新语法编译通过

🌈 终极体验：
你甚至可以在每个项目根目录放个 .go-version 文件（echo "1.21.6" > .go-version），
再配个 shell hook 自动 g use $(cat .go-version) ——
像 Node 的 .nvmrc 一样优雅～

（注：g 官方暂未内置此功能，但社区脚本已实现 👀）

---

⚖️ 五、g vs 手动管理 vs 其他工具

方式	优点	缺点	适合人群
g ✅	一键安装/切换、自动镜像、零配置、跨平台	不支持源码编译	99% Go 开发者
手动改 GOROOT	100% 控制权	易出错、难回滚、多人协作灾难	受虐型极客
gvm（旧）	曾经的王者	已归档、不维护、Mac ARM 支持差	怀旧党
Docker	环境隔离完美	启动慢、体积大、IDE 调试麻烦	微服务重度用户

🎯 结论：

• 日常开发 → g 是最优解
• 生产部署 → 用 Docker + 固定 Go 镜像
• 想贡献 Go 源码 → 手动编译（g 不支持）

---

🍮 六、Bonus：g 的隐藏彩蛋

# 查 g 自己的版本
$ g version
g version 2.2.0
build: 2024-05-01T10:00:00+08:00

# 自更新（>=1.5.0 支持）
$ g self update
You are up to date! g v2.2.0 is the latest version.

# 自卸载（真·干净）
$ g self uninstall
Are you sure? (Y/n) y
Remove /Users/you/.g/bin/g
Remove /Users/you/.g

---

🎁 结语：让版本管理，不再成为生产力瓶颈

“好的工具，不是让你多干活——
而是让你少为工具干活。”

用 g 之后：

• ✅ go version 不再是薛定谔的猫
• ✅ 同事说“跑不通”时，你先问：“你用的 g ls 是啥？”
• ✅ 终于敢在 PR 里写：// requires go1.25+ 😎

---