Debian Golang配置需要注意什么

在 Debian 上配置 Golang（Go 语言环境）时，有几个容易踩坑的点和推荐做法，下面按“安装 → 环境 → 使用 → 常见坑”来梳理。

一、安装方式选择（很重要）

✅ 推荐：官方二进制包（最稳）

Debian 自带仓库的 Go 通常版本偏旧，不建议用 apt 装生产环境。

# 示例（请替换为最新版本）
wget https://go.dev/dl/go1.22.5.linux-amd64.tar.gz
sudo rm -rf /usr/local/go
sudo tar -C /usr/local -xzf go1.22.5.linux-amd64.tar.gz

⚠️ 不推荐

apt install golang-go

除非你只是跑旧工具，不在意版本。

二、环境变量配置（核心）

1️⃣ 基础 PATH（必须）

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

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

验证：

go version

2️⃣ GOPATH（新手最容易混）

Go 1.11+（模块化后）

普通项目不需要手动设 GOPATH

但如果你用老项目或工具：

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

3️⃣ Go Modules（强烈建议开启）

go env -w GO111MODULE=on

查看当前配置：

go env

三、网络与代理（国内特别注意）

设置 GOPROXY

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

或：

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

关闭私有仓库代理（如有）

go env -w GOPRIVATE=git.example.com

四、权限与用户问题

❌ 不要这样

sudo go build

✅ 正确做法

用普通用户写代码
只在安装时用 sudo

否则会导致：

$GOPATH 权限混乱
go install 失败

五、系统依赖（CGO 场景）

如果你的项目用了：

SQLite
某些加密库
调用 C 代码

需要安装：

sudo apt install gcc libc-dev

检查：

go env CGO_ENABLED

应为 1

六、Debian 特有问题

1️⃣ 多用户服务器

每个用户单独配置 ~/.bashrc
不要改 /etc/profile 除非你很清楚

2️⃣ systemd 服务

Go 程序用 systemd 跑时：

环境变量不会自动加载
需要在 .service 里写：

[Service]
Environment=GOPATH=/home/user/go
ExecStart=/home/user/go/bin/app

七、推荐目录结构（干净不踩坑）

~/go/
├── bin/
├── pkg/
└── src/

项目放：

~/projects/myapp

八、快速检查清单 ✅

[ ] go version 正常
[ ] go env GOPROXY 已设置
[ ] 不在 root 下写代码
[ ] 没用 apt 的旧版本 Go
[ ] CGO 项目装了 gcc

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

Debian 版本（11 / 12？）
用途（开发 / 服务器运行 / CI）
是否用 Docker

我可以给你一份完全贴合你场景的配置方案。