Debian配置Golang要注意什么

在 Debian 上配置 Golang（Go 语言环境）时，有几个常见坑和最佳实践需要注意，下面按「安装方式 → 环境配置 → 常见注意点」来说明。

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

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

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

# 示例（以 amd64 为例）
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

❌ 不推荐

sudo apt install golang

原因：

版本旧
有时拆分多个包（golang-go / gccgo）
路径不统一

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

1️⃣ 修改用户环境变量

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

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

然后：

source ~/.bashrc

2️⃣ 验证

go version
go env GOPATH

三、GOPATH / GOMOD 注意事项

✅ Go 1.16+ 默认开启 Go Modules

不需要手动设置 GOPATH 来写项目

推荐做法：

go mod init example.com/project

注意：

项目不要放在 GOPATH/src 下（旧习惯）
项目可放任意目录

四、权限与用户问题

❗ 不要用 root 跑 go build（开发时）

# 不推荐
sudo go build

五、防火墙 & 网络（容易被忽略）

1️⃣ 代理问题（国内常见）

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

2️⃣ 私有仓库

go env -w GOPRIVATE=git.example.com

六、systemd 服务部署注意

如果你用 Debian 跑 Go 服务：

[Unit]
Description=Go App
After=network.target

[Service]
User=appuser
WorkingDirectory=/opt/myapp
ExecStart=/opt/myapp/app
Restart=always

[Install]
WantedBy=multi-user.target

注意：

用 非 root 用户
日志用 journalctl -u yourapp

七、常见坑总结 ⚠️

问题	说明
apt 安装 Go 版本旧	用官方 tar 包
GOPATH 设置错误	Go Modules 下基本不用管
使用 root 开发	权限混乱
代理没配	`go get` 超时
CGO 未关	交叉编译失败
忘了 `source`	环境变量不生效

八、推荐最小可用配置（示例）

# ~/.bashrc
export PATH=$PATH:/usr/local/go/bin
export GOPROXY=https://goproxy.cn,direct

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

Debian 版本（11 / 12）
用途（开发 / 服务器部署 / CI）
是否用 Docker

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