Debian怎么配置Golang模块

在 Debian 上配置 Go（Golang）模块（Go Modules），通常包括 安装 Go、配置环境变量、初始化和使用模块。下面按步骤说明。

一、在 Debian 上安装 Go

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

1. 卸载旧版本（如果有）

sudo apt remove golang golang-go

2. 下载最新 Go（以 1.22 为例，可去官网查最新版本）

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

3. 解压到 /usr/local

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

4. 配置环境变量
   编辑 ~/.bashrc 或 ~/.zshrc：

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

然后：

source ~/.bashrc

5. 验证

go version

方法 2：使用 Debian 仓库（版本可能较旧）

sudo apt update
sudo apt install golang-go

⚠️ 不推荐用于模块开发，版本通常落后。

二、配置 Go Modules（重点）

1. 开启 Go Modules（Go 1.16+ 已默认开启）

go env -w GO111MODULE=on

查看当前配置：

go env

重点看：

• GOPATH
• GOMODCACHE
• GO111MODULE
• GOPROXY

2. 配置国内代理（在国内非常推荐）

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

或：

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

3. 初始化一个 Go 模块

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

会生成：

go.mod

4. 编写代码并自动管理依赖

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

运行：

go run .

Go 会自动：

• 下载依赖
• 写入 go.mod
• 生成 go.sum

三、常用 Go Modules 命令

四、常见问题

1. 提示 go: command not found

说明 PATH 没配置好，检查：

echo $PATH

2. 私有仓库拉取失败

go env -w GOPRIVATE=git.example.com

3. Debian 下权限问题

不要在 /usr/local/go 下直接写代码，
代码放在 $HOME 下即可。

五、推荐目录结构

~/projects/
└── hello/
    ├── go.mod
    ├── go.sum
    └── main.go

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

• Debian 版本（11 / 12 / 其他）
• 是否用于 服务器、Docker、私有仓库
• 是否遇到具体报错

我可以给你更精确的配置方案。