ubuntu怎么配置golang模块

ubuntu

小樊

2026-10-28 09:05:53

栏目: 编程语言

在 Ubuntu 上配置 Go（Golang）模块（Go Modules），一般包括 安装 Go、设置环境变量、启用模块、初始化和使用模块 几个步骤。下面按流程说明：

一、安装 Go（Ubuntu）

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

# 下载最新稳定版（示例为 1.22.0，请按需替换）
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：使用 apt（版本可能较旧）

sudo apt update
sudo apt install golang-go

二、配置环境变量

编辑用户环境变量（推荐）：

nano ~/.bashrc

在末尾添加：

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 GO111MODULE

on：强制使用模块
auto：默认（推荐）

如需强制开启：

go env -w GO111MODULE=on

四、初始化 Go 模块

进入你的项目目录：

mkdir myproject
cd myproject

初始化模块：

go mod init github.com/yourname/myproject

会生成：

go.mod

五、添加依赖（示例）

写一个 main.go：

package main

import (
    "fmt"
    "github.com/gin-gonic/gin"
)

func main() {
    r := gin.Default()
    r.GET("/", func(c *gin.Context) {
        c.JSON(200, gin.H{"msg": "hello"})
    })
    r.Run()
}

自动下载依赖：

go mod tidy

会生成/更新：

go.mod
go.sum

六、常用 Go 模块命令

go mod init        # 初始化
go mod tidy        # 清理并下载依赖
go mod download    # 下载依赖
go mod verify      # 校验依赖
go get pkg@version # 添加指定版本依赖
go list -m all     # 查看依赖

七、设置代理（国内推荐）

go env -w GOPROXY=https://proxy.golang.com.cn,direct

如果你愿意，我可以：

帮你写一个 最小 Go 项目示例
配置 VS Code / GoLand
配置 Go 私有模块（GitLab / GitHub）

你可以告诉我你的 Ubuntu 版本和 Go 版本。