Bootstrap

Mac 上管理本地 Go 版本

在 Mac 上修改本地 Go 版本可以通过多种方法实现。以下是几种常见且详细的操作方案:


方法一:使用 goenv 管理多版本(推荐)

适用场景:需要频繁切换不同 Go 版本,适合长期开发者。

步骤:
  1. 安装 goenv

    # 使用 Homebrew 安装
    brew install goenv
    
  2. 配置环境变量
    将以下内容添加到 Shell 配置文件(如 ~/.zshrc~/.bash_profile):

    export GOENV_ROOT="$HOME/.goenv"
    export PATH="$GOENV_ROOT/bin:$PATH"
    eval "$(goenv init -)"
    export PATH="$GOPATH/bin:$PATH"
    

    保存后执行:

    source ~/.zshrc  # 或 source ~/.bash_profile
    
  3. 安装指定 Go 版本

    # 查看可安装版本
    goenv install --list
    
    # 安装特定版本(如 1.21.0)
    goenv install 1.21.0
    
  4. 切换版本

    # 全局默认版本
    goenv global 1.21.0
    
    # 仅当前目录生效
    goenv local 1.21.0
    
  5. 验证版本

    go version
    

方法二:手动下载并替换

适用场景:临时使用特定版本,无需频繁切换。

步骤:
  1. 卸载旧版本(如已通过 Homebrew 安装):

    brew uninstall go
    
  2. 下载目标版本

    • 访问 Go 官方下载页,选择 macOS 的 .tar.gz 包(如 go1.21.0.darwin-amd64.tar.gz)。
  3. 解压并安装

    # 删除旧版本(如果存在)
    sudo rm -rf /usr/local/go
    
    # 解压到系统目录
    sudo tar -C /usr/local -xzf ~/Downloads/go1.21.0.darwin-amd64.tar.gz
    
  4. 更新环境变量
    在 Shell 配置文件中添加:

    export PATH="/usr/local/go/bin:$PATH"
    

    保存后执行:

    source ~/.zshrc  # 或 source ~/.bash_profile
    
  5. 验证版本

    go version
    

方法三:使用 asdf 管理多版本

适用场景:需要管理多种语言版本(如 Node.js、Python、Go 等)。

步骤:
  1. 安装 asdf

    brew install asdf
    
  2. 配置环境变量
    在 Shell 配置文件中添加:

    . $(brew --prefix asdf)/libexec/asdf.sh
    
  3. 安装 Go 插件

    asdf plugin-add golang https://github.com/kennyp/asdf-golang.git
    
  4. 安装指定版本

    asdf install golang 1.21.0
    
  5. 切换版本

    # 全局生效
    asdf global golang 1.21.0
    
    # 当前目录生效
    asdf local golang 1.21.0
    
  6. 验证版本

    go version
    

方法四:使用 Homebrew 切换版本

适用场景:通过 Homebrew 安装的 Go,需要临时切换版本。

步骤:
  1. 安装旧版本(如需非最新版):

    # 查找可用版本
    brew search go@
    
    # 安装指定版本(如 [email protected]
    brew install [email protected]
    
  2. 链接版本

    # 取消当前链接
    brew unlink go
    
    # 链接目标版本
    brew link --force [email protected]
    
  3. 验证版本

    go version
    

常见问题解决

  1. 权限问题

    • 使用 sudo 执行解压或删除操作(如方法二)。
  2. 环境变量未生效

    • 确保修改 Shell 配置文件后执行 source 命令,或重启终端。
  3. 多版本冲突

    • 使用工具(如 goenvasdf)避免手动管理混乱。

选择最适合你的方法,通常推荐使用 goenvasdf 进行多版本管理!

悦读

道可道,非常道;名可名,非常名。 无名,天地之始,有名,万物之母。 故常无欲,以观其妙,常有欲,以观其徼。 此两者,同出而异名,同谓之玄,玄之又玄,众妙之门。

;