M1 芯片 Mac 上更好的 Golang 使用方案

本篇文章，将分享如何在苹果 M1 Mac 设备上，来进行高效、可靠的 Golang 开发环境的安装和管理。

写在前面

如果你是一个 Golang 的用户，那么你大概率会遇到管理和维护 Golang 版本的诉求，如果你恰好同时需要开发调试两个不同版本的项目，在不考虑强制跳版本的情况下，你或许就需要使用“Golang 版本管理工具”来帮助你减轻负担了。

去年年末，我曾在一篇文章中分享过三种关于《Golang 多版本管理》的方案。

相比较官方方案 golang/dl 或者社区方案 voidint/g 这两个更适合安装或管理单一版本的方案之外，我更推荐使用的方案是 gvm 。

它除了能够完成 golang 开发环境的快速安装之外，还能够保障多个版本的 golang 共存，不同版本的软件依赖包都保持正常工作。并且，它的实现和社区大名鼎鼎的 nvm-sh/nvm 、shyiko/jabba 是一致的，都是由 BASH 编写，和所需要管理的 Runtime 语言无关，能够更稳定的完成“管理工作”。

但可惜的是，它和 M1 设备存在兼容性问题，它并不能够很好的运行，甚至可以说，完全无法运行。

暂且不说我是如何解决问题的，让我们先来看看，怎么能够在数秒、几分钟内完成 Golang 开发环境的安装和切换吧。

安装和使用 Golang 版本管理工具：`gvm`

想要使用 gvm，需要先完成一次“绿色安装”（下载）。

如何安装 `gvm`

gvm 的安装非常简单，只需要“一句话”：

curl -sSL https://github.com/soulteary/gvm/raw/master/binscripts/gvm-installer | bash

当命令执行完毕之后，我们可以看到类似下面的日志输出：

Cloning from https://github.com/soulteary/gvm.git to /Users/soulteary/.gvm
No existing Go versions detected
Installed GVM v1.0.24

Please restart your terminal session or to get started right away run
 `source /Users/soulteary/.gvm/scripts/gvm`

接下来，我们选择重新打开命令行终端，或者是选择执行上一步提示的 source /Users/soulteary/.gvm/scripts/gvm 命令都可以让安装的 gvm 命令生效。

如何使用 `gvm` 安装 Golang 开发环境

当 gvm 安装完毕之后，假设我们要安装最新的 golang 1.18.2，只需要执行下面的命令即可：

gvm install go1.18.2 -B

稍等片刻，当命令行中提示 Installing go1.18.2 from binary source 的时候，指定 golang 开发环境就安装完毕啦，是不是很简单！

除了“下载”之外，还需要执行下面的命令，将我们刚刚下载的版本在当前的命令行环境中 “激活”：

gvm use go1.18.2

如果我们希望刚刚下载的 golang 版本全局生效，并且作为默认的使用版本，可以在命令行后面添加 --default 参数：

gvm use go1.18.2 --default

不论使用哪一种方式，当命令执行完毕之后，我们将得到提示：Now using version go1.18.2。接着，我们就正常可以使用 go 了，比如执行 go version：

go1.18.2 darwin/arm64

如何使用 `gvm` 进行多版本切换

想使用不同版本的 golang 的方法和上面其实并没有什么不同。依旧是先使用 install 命令，安装我们想要的版本：

gvm install go1.18.1 -B

当看到 Installing go1.18.1 from binary source 提示之后，我们接着使用 use 命令，激活这个版本就好了：

gvm gvm use go1.18.1
#或者
gvm gvm use go1.18.1 --default

当命令执行完毕，我们会得到熟悉的 Now using version go1.18.1 提示。

如何使用 `gvm` 进行编译安装

有的同学因为一些诉求，可能不想下载预编译好的内容，而是希望进行本地编译。

那么可以在使用 install 命令下载 golang 的时候，去掉 -B 参数：

gvm install go1.18

当命令执行完毕之后，我们会看到带有编译过程的日志：

Downloading Go source...
Installing go1.18...
 * Compiling...
go1.18 successfully installed!

接着就是和上文中提到的一样，根据自己需求使用 use 来激活命令了。

如何卸载 `gvm` 或进行重置

先聊聊软件的卸载，在前文提到过 gvm 是一个“绿色软件”，卸载方式十分简单，将 ~/.gvm 目录删除，然后清理掉前文中我们在 ~/.zshrc 或 ~/.bashrc 中添加的内容即可。

如果你希望进行软件重置，我推荐你在“卸载之后”，再次进行安装即可。

如何解决某个版本下载不顺利的问题

在上一篇内容中，我们曾提到过如何解决这个问题。原理在此就不过多赘述了，感兴趣的同学自行翻阅即可。

简单来说，如果遇到下载二进制文件出现问题，可以尝试进行缓存清理：

rm -rf ~/.gvm/archive/

好了，关于 gvm 的使用部分就讲完了。

聊聊为了解决“兼容性”问题，我做了哪些事情。

解决 `gvm` 兼容性问题

如果你有使用过 gvm，会发现上文中的安装仓库并不是官方仓库，而是我的修改版本 soulteary/gvm。那么在这里修改版本里，我到底做了哪些事情呢？

如果我们使用官方命令进行 gvm 安装，大概率会碰到几个问题导致不能安装，当我们使用 install 命令进行安装的时候，默认的版本会告诉我们发生了下面的错误：

# gvm install go1.18.2 -B

Installing go1.18 from binary source
ERROR: Binary Go unavailable for this platform

要解决这个问题，我们需要调整 scripts/install 相关程序实现：

download_binary() {
    mkdir -p $GO_INSTALL_ROOT >> "${GVM_ROOT}/logs/go-${GO_NAME}-download-binary" 2>&1
    if [ "$(uname)" == "Darwin" ]; then
        GVM_OS="darwin"
        osx_major_version="$(sw_vers -productVersion | cut -d "." -f 2)"
        if [ "${osx_major_version}" -ge 8 ]; then
            GVM_OS_VERSION="-osx10.8"
        elif [ "${osx_major_version}" -ge 6 ]; then
            GVM_OS_VERSION="-osx10.6"
        else
            display_error "Binary Go unavailable for this platform"
            rm -rf $GO_INSTALL_ROOT
            rm -f $GO_BINARY_PATH
            exit 1
        fi
    else
        GVM_OS="linux"
    fi

    if [ "$(uname -m)" == "x86_64" ]; then
        GVM_ARCH="amd64"
    elif [ "$(uname -m)" == "ppc64le" ]; then
            GVM_ARCH="ppc64le"
    elif [ "$(uname -m)" == "aarch64" ]; then
                GVM_ARCH="arm64"
    else
        GVM_ARCH="386"
    fi
    ...

上面这段程序中，其实存在两个问题。不过，我们先来解决上文提到的第一个问题：Binary Go unavailable for this platform。

默认的程序缺少了针对 M1 设备的判断：

if [ "$(uname -m)" == "x86_64" ]; then
    GVM_ARCH="amd64"
elif [ "$(uname -m)" == "ppc64le" ]; then
        GVM_ARCH="ppc64le"
elif [ "$(uname -m)" == "aarch64" ]; then
            GVM_ARCH="arm64"
else
    GVM_ARCH="386"
fi

先通过执行 uname -m ，得到 M1 设备的架构名称：arm64，接着完善上面的程序：

if [ "$(uname -m)" == "x86_64" ]; then
    GVM_ARCH="amd64"
elif [ "$(uname -m)" == "ppc64le" ]; then
        GVM_ARCH="ppc64le"
elif [ "$(uname -m)" == "aarch64" ]; then
            GVM_ARCH="arm64"
elif [ "$(uname -m)" == "arm64" ]; then
	            GVM_ARCH="arm64"
else
    GVM_ARCH="386"
fi

更新完毕程序之后，我们再次执行 install 命令，会得到一个新的错误：

# gvm install go1.18 -B

Installing go1.18.2 from binary source
ERROR: Failed to download binary go

再次审查上面的逻辑，可以定位到大概率出错的位置：

osx_major_version="$(sw_vers -productVersion | cut -d "." -f 2)"
if [ "${osx_major_version}" -ge 8 ]; then
  GVM_OS_VERSION="-osx10.8"
elif [ "${osx_major_version}" -ge 6 ]; then
  GVM_OS_VERSION="-osx10.6"
else
  display_error "Binary Go unavailable for this platform"
  rm -rf $GO_INSTALL_ROOT
  rm -f $GO_BINARY_PATH
  exit 1
fi

推测大概率是 sw_vers 命令的输出结果产生了变化，导致整段程序结果和预期有偏差，我们尝试执行一下相关的命令，进行下验证：

# sw_vers

ProductName:    macOS
ProductVersion: 12.3.1
BuildVersion:   21E258

# sw_vers -productVersion

12.3.1

# sw_vers -productVersion | cut -d "." -f 2

3

经过上面的日志输出，我们可以确认之前的猜想是正确的，语义化版本的格式是 {major}.{minor}.{revision}，虽然预期中的结果是 {major}，但上面的命令执行后，我们得到的结果却是：{minor} 。

要解决这个问题也很简单，我们可以将 cut -d "." -f 2 调整为 cut -d "." -f 1 来解决在 macOS 11.6 ～ macOS 12 以上的系统版本中，原始程序获取版本出错的问题。

除此之外，我还调整了一些文档、安装、Golang 默认镜像等细节，如果感兴趣的话，可以浏览这里的变更记录。https://github.com/soulteary/gvm/releases/tag/1.0.24

最后

在今年3月份苹果发布会之后，苹果官方所有设备都告别了 x86 处理器，完成了“去英特尔化”，自此所有设备都换上了自研的 M1 芯片。

这件事对于苹果而言不见得是一件坏事，但是对于开发者而言，可能是一件麻烦事：因为再也无法在官方渠道购买到非 ARM 架构的设备了，但是开发者生态相关的开源项目，其实有不少，都存在上文中提到的兼容性问题，亟待改进。

希望我的这篇文章，可以帮助你节约大量不必要的折腾时间，更安心的在 Mac 设备上使用 Golang 进行愉快的开发。

–EOF

砥砺

M1 芯片 Mac 上更好的 Golang 使用方案

写在前面

安装和使用 Golang 版本管理工具：gvm

如何安装 gvm

如何使用 gvm 安装 Golang 开发环境

如何使用 gvm 进行多版本切换

如何使用 gvm 进行编译安装

如何卸载 gvm 或进行重置