linux golang如何配模块

linux

小樊

2026-10-21 18:08:19

栏目: 编程语言

在 Linux 下使用 Go（Golang）配置和使用模块（Go Modules），其实就是用 Go 自带的包管理工具。下面从环境准备 → 初始化模块 → 使用依赖 → 常见问题给你一步步说明。

一、环境准备（Linux）

1. 安装 Go

sudo apt update
sudo apt install golang-go

或官方安装（推荐）：

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 或 ~/.zshrc：

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

使配置生效：

source ~/.bashrc

验证：

go version

二、创建并初始化 Go 模块

1. 新建项目目录

mkdir myproject
cd myproject

2. 初始化模块

go mod init github.com/yourname/myproject

会生成：

go.mod

示例 go.mod：

module github.com/yourname/myproject

go 1.22

三、添加和使用依赖

1. 写代码（示例）

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, "hello")
    })
    fmt.Println("start")
    r.Run()
}

2. 自动下载依赖

go mod tidy

会生成：

go.mod
go.sum

四、常用 Go Module 命令

命令	作用
`go mod init`	初始化模块
`go mod tidy`	清理并下载依赖
`go get pkg`	添加依赖
`go mod download`	下载依赖
`go mod vendor`	导出依赖到 vendor
`go list -m all`	查看依赖

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

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

查看：

go env GOPROXY

六、常见问题

1. 老项目没有 go.mod

go mod init yourmodule
go mod tidy

2. 私有仓库

go env -w GOPRIVATE=git.example.com

3. Go 版本不兼容

修改 go.mod：

go 1.20

如果你愿意，可以告诉我：

你是 初学者 / 实战项目 / 微服务
用的是 Gin / Beego / 原生 net/http
是否使用 私有仓库

我可以直接帮你写一个完整可运行的模块示例。