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

本文使用「署名 4.0 国际 (CC BY 4.0)」许可协议，欢迎转载、或重新修改使用，但需要注明来源。 署名 4.0 国际 (CC BY 4.0)

本文作者: 苏洋

创建时间: 2022年05月12日

统计字数: 5379字

阅读时间: 11分钟阅读

本文链接: https://soulteary.com/2022/05/12/better-golang-usage-on-m1-mac.html