debian配置golang要注意啥

在 Debian 上配置 Go（Golang）环境，有几个常见坑和最佳实践需要注意。下面按「安装方式 → 环境变量 → 权限与目录 → 版本管理 → 常见问题」给你梳理一下。

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

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

Debian 自带仓库的 golang 往往版本偏旧，不建议直接 apt install golang。

# 以 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

❌ 不推荐

• apt install golang（版本旧）
• 用 snap 装 Go（权限和 PATH 容易出问题）

二、环境变量配置（最关键）

编辑用户环境变量（推荐 ~/.profile 或 ~/.bashrc）：

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

然后：

source ~/.bashrc
go version

✅ 检查：

which go
# 应输出 /usr/local/go/bin/go

三、GOPATH 和项目目录（容易踩坑）

Go 1.11+ 模块模式（现在默认）

• 不需要把项目放 GOPATH/src
• 任意目录都可：

mkdir ~/projects/hello
cd ~/projects/hello
go mod init hello

GOPATH 默认位置

• 默认：$HOME/go
• 可执行文件会装到：$GOPATH/bin

⚠️ 注意：

• $GOPATH/bin 必须加入 PATH，否则 go install 后命令用不了

四、权限问题（服务器常见）

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

• 容易导致文件属主混乱
• 推荐普通用户开发

✅ 仅安装 Go 用 root

sudo tar -C /usr/local -xzf go*.tar.gz

五、代理与网络（国内必看）

设置 GOPROXY（非常重要）

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

其他可选：

go env -w GOSUMDB=off   # 仅内网/测试环境

查看当前配置：

go env

六、多版本管理（进阶）

如果你需要多个 Go 版本：

方案 1：go 目录切换（简单）

/usr/local/go1.21
/usr/local/go1.22

手动改软链：

sudo ln -sf /usr/local/go1.22 /usr/local/go

方案 2：gvm（不推荐新手）

• 容易和环境变量冲突

七、systemd 服务注意（部署）

如果 Go 程序作为服务运行：

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

⚠️ 注意：

• 不要依赖 ~/.bashrc 里的环境变量
• 在 service 文件里显式写 Environment=

八、常见错误速查

如果你告诉我：

• 是 桌面还是服务器
• 是否 国内网络
• 是否用于 开发 / 生产部署

我可以给你一套针对性配置方案。