Debian 多版本共存 Go 安装教程

有时候系统自带的 Go 版本比较旧，但有些项目又需要更高版本。
这时候比较稳的做法就是：

• 保留 Debian 系统自带的 Go
• 用系统的 Go 去安装多个指定版本的 Go 包装器
• 再分别下载对应版本的 Go 工具链
• 最终实现 多个 Go 版本共存

这篇文章就是记录一下我自己的安装过程。
按我的步骤来，基本就能跑通。

1. 安装 Debian 系统自带的 Go

先安装 Debian 自带的 Go。

sudo apt install golang   # 安装 Debian 自带的 Go，用来启动环境

Debian 系统自带的 Go，主要用来管理和安装其他 Go 版本。

2. 安装指定版本的 Go 包装器

这里要注意：
这一步 不是直接安装完整的 Go 工具链，而是先安装对应版本的 包装器命令。

比如：

go install golang.org/dl/go1.25.8@latest   # 安装 go1.25.8 的版本包装器
go install golang.org/dl/go1.26.2@latest   # 安装 go1.26.2 的版本包装器

go1.25.8、go1.26.2 只是示例，你可以按自己的需要替换成别的版本。

3. 查看包装器是否已经生成

如果没有自定义 GOPATH，那么 go install 生成的可执行文件通常会放在：

~/go/bin

可以先看一下家目录下有没有 go 文件夹：

cd ~
ls   # 查看是否生成了 go/ 目录

再进入 ~/go/bin 看一下：

ls ~/go/bin   # 查看版本包装器是否已经生成

如果正常的话，你应该能看到类似下面这样的命令：

• go1.25.8
• go1.26.2

4. 把~/go/bin加入 PATH

如果这一步不做，终端可能会提示找不到 go1.25.8 或 go1.26.2 命令。

编辑 ~/.bashrc：

vim ~/.bashrc

在空白处加入这一行：

export PATH="$PATH:$HOME/go/bin"

如果你用的是 zsh，那就改 ~/.zshrc。

保存后执行：

source ~/.bashrc

这样新的 PATH 就生效了。

5. 下载并安装对应版本的 Go 工具链

前面只是安装了包装器，
现在才是真正下载对应版本的 Go 工具链。

先下载 Go 1.26.2：

go1.26.2 download   # 下载并安装 Go 1.26.2 工具链
go1.26.2 version    # 查看 Go 1.26.2 是否安装成功

再下载 Go 1.25.8：

go1.25.8 download   # 下载并安装 Go 1.25.8 工具链
go1.25.8 version    # 查看 Go 1.25.8 是否安装成功

6. 验证多版本共存

你现在就可以分别查看不同版本：

go version
go1.25.8 version
go1.26.2 version

如果都能正常输出版本号，就说明多版本共存已经成功了。

7. 总结

这套方法的核心思路其实很简单：

1. 安装 Debian 系统自带的 Go
2. 用系统 Go 安装多个指定版本的 Go 包装器
3. 把 ~/go/bin 加入 PATH
4. 执行 go1.xx.x download 下载对应版本工具链
5. 最终实现多个 Go 版本共存

这种方式的好处是：

• 不影响系统原来的 Go
• 可以同时保留多个版本
• 切换版本方便
• 对需要兼容不同 Go 版本的项目很实用

8. 补充说明

8.1 为什么要先装 Debian 自带的 Go？

因为 go install golang.org/dl/...@latest 这一步本身就需要先有一个可用的 Go 环境。
所以最省事的方法，就是先用 Debian 系统自带的 Go 把环境启动起来。

8.2 为什么执行完go install后还是不能直接用？

因为 go install 安装出来的包装器默认放在：

~/go/bin

如果这个目录没有加入 PATH，终端就找不到对应命令。

8.3 为什么go install之后还要再执行download？

因为：

go install golang.org/dl/go1.25.8@latest

这一步只是安装了一个叫 go1.25.8 的命令包装器，
并没有把完整的 Go 1.25.8 工具链下载下来。

真正安装完整工具链的是：

go1.25.8 download

9. 完整命令汇总

sudo apt install golang
go install golang.org/dl/go1.25.8@latest
go install golang.org/dl/go1.26.2@latest
ls ~/go/bin
vim ~/.bashrc
export PATH="$PATH:$HOME/go/bin"
source ~/.bashrc
go1.26.2 download
go1.26.2 version
go1.25.8 download
go1.25.8 version
go version
go1.25.8 version
go1.26.2 version

10. 结尾

官方文档有些地方写得比较简略，第一次配的时候确实容易卡住。
尤其是：

• 不知道包装器装到哪里了
• 不知道为什么命令找不到
• 不知道为什么还要再执行一次 download

参考：Go 官方文档：Managing Go installations

到此这篇关于Debian 多版本共存 Go 安装教程的文章就介绍到这了,更多相关Debian 多版本共存 Go 内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！