Ubuntu如何配置Golang路径

Ubuntu 配置 Golang 路径

一 确认安装方式与路径

• 使用发行版仓库安装：执行 sudo apt update && sudo apt install golang，Go 通常位于 /usr/lib/go（Debian/Ubuntu 常见路径）。
• 使用官网压缩包安装：从 golang.org/dl 下载 .tar.gz，解压到 /usr/local/go（推荐）或自定义目录。
• 快速确认：执行 which go 与 go env GOROOT 查看当前可执行文件与安装前缀。

二 配置环境变量

• 选择配置文件（按登录会话生效范围选择其一）：
  • 当前用户登录会话：编辑 ~/.profile 或 ~/.bashrc；
  • 所有用户：创建 /etc/profile.d/golang.sh（系统级）。
• 写入以下内容（注意替换为你的实际安装路径，如 /usr/local/go 或 /usr/lib/go）：
  • 通用最小配置
    • export GOROOT=/usr/local/go
    • export GOPATH=$HOME/go
    • export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
  • 可选优化（Go 1.13+ 建议开启模块、设置国内代理）
    • export GO111MODULE=on
    • export GOPROXY=https://goproxy.cn,direct
• 使配置立即生效：source ~/.profile 或 source ~/.bashrc；系统级脚本需重新登录或执行 source /etc/profile.d/golang.sh。

三 验证与常见问题

• 验证命令
  • go version（输出版本号）
  • go env（检查 GOROOT、GOPATH、PATH、GO111MODULE、GOPROXY 等）
  • echo $GOROOT && echo $GOPATH（核对路径）
• 常见问题
  • 命令未找到：检查 PATH 是否包含 $GOROOT/bin 与 $GOPATH/bin，并确认已执行 source。
  • 多用户与登录方式：图形登录通常读取 ~/.profile；仅打开终端可能只读取 ~/.bashrc；系统级统一配置用 /etc/profile.d/golang.sh。
  • 路径不一致：apt 安装多为 /usr/lib/go；官网压缩包多为 /usr/local/go，以 go env GOROOT 为准。

四 快速测试与模块示例

• 创建工作区并初始化模块：
  • mkdir -p $HOME/goprojects/hello && cd $HOME/goprojects/hello
  • go mod init example.com/hello
• 创建 hello.go：
  • package main
    import “fmt”
    func main() { fmt.Println(“Hello, World!”) }
• 运行：go run hello.go（应输出 Hello, World!）。