配置Debian Golang要注意什么

在 Debian 上配置 Go（Golang）开发环境时，有几个关键点需要注意，尤其是版本选择、环境变量、权限和模块管理。下面按步骤和注意事项说明。

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

✅ 推荐方式：官方二进制安装（最稳妥）

Debian 官方仓库里的 Go 版本通常较旧，不推荐用于生产或新项目。

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

sudo apt remove golang golang-go

2. 下载官方 Go

查看最新版本：https://go.dev/dl/

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

3. 解压到 /usr/local

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

二、环境变量配置（最容易出错）

1. 配置 PATH（必须）

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

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

然后：

source ~/.bashrc

2. 验证

go version
go env

三、GOPATH 与 Go Modules（重点）

✅ 现代 Go（1.16+）建议：使用 Go Modules，而不是 GOPATH

go env GO111MODULE

推荐：

go env -w GO111MODULE=on

项目示例

mkdir hello && cd hello
go mod init example.com/hello

四、代理与国内网络问题（中国大陆必看）

配置 GOPROXY

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

或：

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

关闭模块校验（可选）

go env -w GOSUMDB=off

五、权限与目录问题

❌ 不要做的事

• ❌ 不要 sudo go build
• ❌ 不要把项目放在 /usr/local

✅ 推荐做法

• 项目放在 $HOME 下
• 如需安装工具：

go install golang.org/x/tools/gopls@latest

六、Debian 特有注意事项

1. 防火墙 / 端口

如果写网络程序：

sudo apt install ufw
sudo ufw allow 8080

2. 多版本 Go（可选）

推荐使用：

• gvm
• 或手动切换 /usr/local/go 软链接

3. systemd 服务（生产环境）

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

[Service]
ExecStart=/home/user/app/server
User=user

[Install]
WantedBy=multi-user.target

七、常见错误排查

❌ go: command not found

• PATH 没配置好
• 忘了 source ~/.bashrc

❌ permission denied

• 用 sudo 运行 go 命令
• 或目录权限不对

❌ 下载包超时

• GOPROXY 没配置
• 网络被墙

八、推荐开发工具

go install golang.org/x/tools/gopls@latest

编辑器：

• VS Code + Go 插件
• GoLand

总结（最关键 5 点）

✅ 用官方二进制，不用 apt
✅ 正确配置 PATH
✅ 使用 Go Modules
✅ 配置 GOPROXY
✅ 不要滥用 sudo

如果你愿意，我可以：

• 给你一份 Debian + Go 的完整安装脚本
• 或针对 服务器 / 桌面 / 容器 场景单独说明