如何查Debian Golang配置错

在 Debian 上“Golang 配置错”通常指 环境变量不对、版本冲突、模块代理不通、或编译/运行报错。下面按最常见问题 → 排查方法给你一个实用清单。

一、先确认 Go 是否装对了

which go
go version

正常应类似：

/usr/local/go/bin/go
go version go1.22.2 linux/amd64

常见问题

• command not found → 没装或没加 PATH
• 版本太老（Debian 自带 golang-go 常很旧）

推荐安装方式（Debian）

sudo rm -rf /usr/local/go
wget https://go.dev/dl/go1.22.2.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.22.2.linux-amd64.tar.gz

二、检查 Go 环境变量（非常关键）

go env

重点看这几个：

GOPATH
GOROOT
GOBIN
GOPROXY
GO111MODULE

正确示例（一般用户）

GOROOT="/usr/local/go"
GOPATH="$HOME/go"
GOBIN="$HOME/go/bin"
GOPROXY="https://proxy.golang.org,direct"
GO111MODULE="on"

三、Debian 下最常见配置错误

1️⃣ PATH 没配

编辑：

nano ~/.bashrc

加：

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

生效：

source ~/.bashrc

2️⃣ 同时装了 apt 的 go 和官方 go（冲突）

dpkg -l | grep golang

如果有：

sudo apt remove golang-go golang-any

3️⃣ 模块下载失败（国内常见）

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

测试：

go mod init test
go get github.com/gin-gonic/gin

4️⃣ 权限问题

不要 sudo go build

错误示例：

sudo go run main.go

正确：

go run main.go

四、快速自检脚本（推荐）

go version
go env GOPATH GOROOT GOPROXY
echo $PATH | grep go

五、如果你有具体报错

直接把报错内容贴出来，例如：

• cannot find package
• go: command not found
• module declares its path
• permission denied

我可以精准告诉你是哪一行配置错了。

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

1. Debian 版本（cat /etc/os-release）
2. 怎么装的 Go（apt / 官方包）
3. 具体报错截图或文字

我可以一步一步帮你修 ✅