温馨提示×

Ubuntu下Golang环境变量怎么设置

小樊
55
2025-08-29 20:43:31
栏目: 编程语言

Ubuntu下Golang环境变量设置步骤

1. 安装Golang(若未安装)

在配置环境变量前,需先安装Golang。推荐通过手动安装最新版本(避免官方仓库版本滞后):

  • 下载最新Go安装包(以go1.21.5.linux-amd64.tar.gz为例):
    wget https://golang.org/dl/go1.21.5.linux-amd64.tar.gz
    
  • 解压至/usr/local目录(需sudo权限):
    sudo tar -C /usr/local -xzf go1.21.5.linux-amd64.tar.gz
    
  • 清理下载文件:
    rm go1.21.5.linux-amd64.tar.gz
    

2. 配置环境变量

环境变量需添加至shell配置文件(根据使用的shell选择):

  • bash用户(默认shell):编辑~/.bashrc文件;
  • zsh用户(如使用Oh My Zsh):编辑~/.zshrc文件。

使用文本编辑器(如nano)打开对应文件,在末尾添加以下内容

# 设置GOROOT(Go安装路径)
export GOROOT=/usr/local/go
# 设置GOPATH(工作目录,用于存放项目、依赖等)
export GOPATH=$HOME/go
# 将Go的二进制命令目录和GOPATH的bin目录添加至PATH
export PATH=$GOROOT/bin:$GOPATH/bin:$PATH

说明

  • GOROOT:指向Go的安装根目录(手动安装时为/usr/local/go,apt安装时为/usr/lib/go);
  • GOPATH:Go的工作目录,默认为$HOME/go(可自定义,但需与后续go env -w设置一致);
  • PATH:将Go命令和项目可执行文件目录加入系统路径,实现全局调用。

3. 使配置生效

保存并关闭文件后,运行以下命令使配置立即生效:

# bash用户
source ~/.bashrc
# zsh用户
source ~/.zshrc

4. 验证环境变量

通过以下命令验证配置是否正确:

  • 查看Go版本(确认命令可用):
    go version
    
    若输出类似go version go1.21.5 linux/amd64,则说明Go命令已可全局调用。
  • 查看环境变量值(确认路径正确):
    go env GOROOT  # 应输出/usr/local/go
    go env GOPATH  # 应输出$HOME/go(如/home/username/go)
    

5. 可选:设置Go模块(现代项目推荐)

若使用Go 1.16及以上版本,建议开启模块支持(无需依赖GOPATH):

go env -w GO111MODULE=on

注意事项

  • 若通过apt安装Go(sudo apt install golang-go),GOROOT默认为/usr/lib/go,需调整环境变量中的路径;
  • 自定义GOPATH后,需确保项目目录结构符合规范($GOPATH/src存放源码、$GOPATH/bin存放可执行文件);
  • 若修改配置后仍无法识别go命令,可重启终端或检查配置文件语法(如nano ~/.bashrc中是否有语法错误)。

0