温馨提示×

Debian下Golang路径怎么设

小樊
44
2026-08-01 10:36:39
栏目: 编程语言

Debian 下设置 Golang(Go)环境变量,主要是配置 GOROOT、GOPATH、PATH。下面按常见场景一步步说明。


一、Debian 安装 Go 的方式

方式 1:用 apt 安装(简单,但版本可能较旧)

sudo apt update
sudo apt install golang-go

安装后一般路径是:

/usr/lib/go

方式 2:官方二进制安装(推荐 ✅)

wget https://go.dev/dl/go1.22.4.linux-amd64.tar.gz
sudo tar -C /usr/local -xzf go1.22.4.linux-amd64.tar.gz

安装路径是:

/usr/local/go

二、设置 Go 环境变量(重点)

1️⃣ 编辑用户环境变量

nano ~/.bashrc

(如果用 zsh,则编辑 ~/.zshrc


2️⃣ 添加以下内容(按安装方式选)

✅ 官方二进制安装(推荐)

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

✅ apt 安装(一般不用设 GOROOT)

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

3️⃣ 使配置生效

source ~/.bashrc

三、验证是否配置成功

go version
go env

你应该能看到:

GOROOT=/usr/local/go
GOPATH=/home/你的用户名/go

四、Go 工作目录结构(重要)

Go 1.11+ 推荐 Go Modules,不强制要求 GOPATH,但 GOPATH 仍然存在:

~/go
├── bin     # go install 生成的可执行文件
├── pkg     # 编译的包
└── src     # 老项目或 go get 代码

✅ 新项目建议直接:

mkdir myproject
cd myproject
go mod init myproject

不需要放在 GOPATH 下。


五、常见错误排查

go: command not found

  • PATH 没生效
  • 检查 go 是否在 /usr/local/go/bin

cannot find package

  • 没启用 Go Modules
  • 或 GOPATH 设置错误

六、一键检查脚本(可选)

go env | grep -E "GOROOT|GOPATH|PATH"

如果你愿意,可以告诉我:

  • Debian 版本(11 / 12)
  • 用 apt 还是官方包
  • 普通用户还是 root

我可以给你一份 完全精确 的配置方案。

0