Debian下如何设置Golang环境变量

在 Debian 下设置 Golang 环境变量，通常包含 GOROOT（Go 安装路径）、GOPATH（工作目录） 和 PATH（命令路径）。下面以 Go 1.21+ 和 amd64 为例说明。

一、安装 Go（如未安装）

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

默认安装路径为：

/usr/local/go

二、设置环境变量（推荐方式）

方式 1：只对当前用户生效（推荐）

编辑用户环境变量文件：

nano ~/.bashrc

在文件末尾添加：

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

保存后执行：

source ~/.bashrc

方式 2：对所有用户生效（服务器常用）

sudo nano /etc/profile.d/golang.sh

写入：

export GOROOT=/usr/local/go
export GOPATH=/opt/go
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

赋予执行权限：

sudo chmod +x /etc/profile.d/golang.sh

重新登录或执行：

source /etc/profile

三、验证是否配置成功

go version
go env GOROOT
go env GOPATH

正常输出示例：

go version go1.21 linux/amd64
/usr/local/go
/home/user/go

四、Go 1.16+ 注意事项（重要）

• Go Modules 已默认开启
• 不强制使用 GOPATH
• 推荐项目结构：

~/project/
├── go.mod
├── main.go

五、常见问题

1. go: command not found

• 检查 PATH 是否包含 $GOROOT/bin
• 是否执行了 source

2. 使用 zsh 而不是 bash

修改：

~/.zshrc

如果你使用的是 Debian 12 / Ubuntu / WSL / Docker，可以告诉我具体环境，我可以给你更精确的配置方式。