centos下如何配置golang模块

centos

小樊

2026-10-08 17:56:47

栏目: 编程语言

在 CentOS 下配置 Go 模块（Go Modules），一般包含以下几个方面：安装 Go、开启模块支持、配置代理、初始化模块和管理依赖。下面按步骤说明。

一、安装 Go（CentOS）

1. 使用官方二进制包（推荐）

# 下载（以 go1.22 为例，可自行替换版本）
wget https://go.dev/dl/go1.22.0.linux-amd64.tar.gz

# 解压
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.22.0.linux-amd64.tar.gz

2. 配置环境变量

编辑 ~/.bashrc 或 ~/.profile：

export PATH=$PATH:/usr/local/go/bin
export GOPATH=$HOME/go
export PATH=$PATH:$GOPATH/bin

使配置生效：

source ~/.bashrc

验证：

go version

二、开启 Go Modules

Go 1.13+ 默认已启用模块，但建议显式配置：

go env -w GO111MODULE=on

三、配置 Go 代理（国内很重要）

在 CentOS 上拉取模块经常受网络影响，建议配置代理：

go env -w GOPROXY=https://proxy.golang.org,direct
# 国内推荐
go env -w GOPROXY=https://goproxy.cn,direct

可选（私有仓库）：

go env -w GOPRIVATE=git.example.com,github.com/yourorg

查看当前配置：

go env

四、初始化 Go 模块

进入你的项目目录：

mkdir myproject
cd myproject
go mod init github.com/yourname/myproject

会生成：

go.mod

五、添加和管理依赖

1. 添加依赖

go get github.com/gin-gonic/gin

2. 自动整理依赖

go mod tidy

3. 查看依赖

go list -m all

4. 升级依赖

go get -u github.com/gin-gonic/gin

六、构建和测试

go build
go run main.go
go test ./...

七、常见问题（CentOS）

1. git 未安装

Go 模块需要 git：

sudo yum install -y git

2. 代理无法访问

尝试：

go env -w GOPROXY=off  # 仅本地

或切换为：

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

3. 老项目（无 go.mod）

go mod init
go mod tidy

如果你有 具体场景（比如私有 GitLab、内网环境、Go 版本、CentOS 7/8），可以告诉我，我可以给你更针对性的配置方案。