Linux VPS 安装 Go 语言开发环境完全指南

概述

Go 语言这几年越来越火,微服务、云原生、CLI 工具都离不开它。很多开发者买了 VPS 想跑 Go 项目,结果卡在环境配置上。这篇教程手把手教你在 Linux VPS 上装好 Go 开发环境,包括版本管理、路径配置和项目初始化。

整个过程大概 10 分钟,适合刚接触 Go 的新人。

准备工作

  • 一台 Linux VPS(推荐 Ubuntu 22.04 或 Debian 12)
  • 有 sudo 权限的账户
  • 能访问互联网

步骤

第一步:卸载系统自带的旧版 Go

有些 VPS 镜像预装了旧版 Go,先清理掉避免冲突。

sudo apt remove -y golang-go golang-src 2>/dev/null
sudo rm -rf /usr/local/go 2>/dev/null
sudo rm -rf /opt/go 2>/dev/null

第二步:下载 Go 安装包

去官网找最新版下载地址,或者直接用以下命令安装稳定版本。

cd /tmp
wget https://go.dev/dl/go1.22.4.linux-amd64.tar.gz

如果你的 VPS 是 ARM 架构(比如 AWS Graviton),换成 linux-arm64

第三步:解压并安装到 /usr/local

sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.22.4.linux-amd64.tar.gz

第四步:配置环境变量

编辑你的 shell 配置文件,把 Go 的可执行文件加入 PATH。

echo 'export PATH=$PATH:/usr/local/go/bin' >> ~/.bashrc
echo 'export GOPATH=$HOME/go' >> ~/.bashrc
echo 'export PATH=$PATH:$GOPATH/bin' >> ~/.bashrc
source ~/.bashrc

GOPATH 是 Go 项目的默认工作目录,所有第三方包都会下载到 $GOPATH/pkg 下面。

第五步:验证安装

go version

输出类似 go version go1.22.4 linux/amd64 就说明装好了。

再检查一下命令是否都能用:

go env GOPATH
go env GOMODCACHE

GOPATH 应该输出 /home/ubuntu/go,GOMODCACHE 输出 /home/ubuntu/go/pkg/mod

第六步:配置 Go Modules(推荐)

现代 Go 项目都使用 Go Modules 管理依赖,不需要再手动配置 GOPATH。

export GO111MODULE=on

把这个也加到 ~/.bashrc 里,永久生效。

第七步:测试编译一个 Hello World

mkdir -p $GOPATH/src/hello
cd $GOPATH/src/hello
go mod init hello

创建 main.go

package main

import "fmt"

func main() {
    fmt.Println("Hello, Go on VPS!")
}

编译运行:

go build .
./hello

看到 Hello, Go on VPS! 就完美了。

第八步:安装常用 Go 工具

go install golang.org/x/tools/gopls@latest
go install github.com/go-delve/delve/cmd/dlv@latest

gopls 是官方语言服务器,dlv 是调试器。有了这两个,你可以用 VS Code 远程连 VPS 写 Go 代码。

常见问题

Q: 提示 command not found?

检查 echo $PATH 里有没有 /usr/local/go/bin。没有的话重新 source ~/.bashrc 或者手动加上。

Q: 下载依赖特别慢?

国内用户建议设置代理:

go env -w GOPROXY=https://goproxy.cn,direct

Q: 怎么升级 Go 版本?

重复第二到第四步,下载新版本覆盖就行。旧的会被自动清理。

Q: Go Modules 模式下 GOPATH 还有用吗?

有用。GOPATH 下的 pkg/mod 缓存所有下载的依赖,bin 存放 go install 编译的二进制文件。即使用了 Modules,这些目录仍然正常工作。

Q: 内存小的 VPS 编译会 OOM 吗?

小项目不会。大项目(比如 Kubernetes)编译可能吃 2GB+ 内存。如果 VPS 只有 1GB,可以加 swap 或者用 go build -ldflags="-s -w" 减小内存占用。

总结

装好 Go 环境后,你就可以在 VPS 上跑各种 Go 项目了——微服务、API 网关、爬虫、甚至 AI 推理服务。Go 的编译速度很快,一次 go build 就能拿到独立可执行文件,部署特别省心。

下一步可以试试在 VPS 上部署一个 Go Web 框架,比如 Gin 或者 Echo。

这篇文章对你有帮助吗?