Ubuntu下Golang如何配置

Ubuntu 下 Golang 配置全流程

一 安装方式选择

• 使用 APT 安装（稳定、简单，版本可能偏旧）
  • 更新索引并安装：sudo apt update && sudo apt install -y golang
  • 验证：go version
• 官方压缩包安装（推荐，便于多版本管理）
  • 下载：wget https://golang.google.cn/dl/go1.23.0.linux-amd64.tar.gz（请替换为最新稳定版）
  • 解压到系统目录：sudo tar -C /usr/local -xzf go1.23.0.linux-amd64.tar.gz
• 版本管理工具 GVM（适合需要在多版本间切换的场景）
  • 安装 GVM：bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscripts/gvm-installer.sh)
  • 使用 GVM：gvm install go1.23.0 && gvm use go1.23.0 --default

二 环境变量与 Shell 配置

• 编辑配置文件（根据所用 Shell 选择其一）
  • Bash：nano ~/.bashrc
  • Zsh：nano ~/.zshrc
• 写入以下内容（官方压缩包安装的典型配置）
  • export GOROOT=/usr/local/go
  • export GOPATH=$HOME/go
  • export PATH=$PATH:$GOROOT/bin:$GOPATH/bin
• 使配置生效
  • Bash：source ~/.bashrc
  • Zsh：source ~/.zshrc
• 说明
  • 使用 APT 安装时，部分系统已设置好 Go 路径，可通过 go env GOROOT 查看实际路径，必要时再补充到 PATH

三 验证安装与第一个程序

• 查看版本与信息
  • go version
  • go env
• 运行示例
  • 创建文件：nano main.go
  • 写入代码：
    • package main
    • import “fmt”
    • func main() { fmt.Println(“Hello, Ubuntu”) }
  • 执行：go run main.go（预期输出：Hello, Ubuntu）

四 常用优化与工具

• 启用模块与国内代理（提升依赖下载速度）
  • go env -w GO111MODULE=on
  • go env -w GOPROXY=https://goproxy.cn,direct
• 使用 Go Modules 初始化项目
  • go mod init
• 编辑器与调试
  • VS Code 安装 Go 扩展（gopls、dlv 等）以获得智能提示与调试支持

五 常见问题排查

• 命令未找到：检查 PATH 是否包含 $GOROOT/bin 与 $GOPATH/bin，并确认已执行 source 使配置生效
• 权限问题：解压到 /usr/local 需要 sudo；用户工作区 $HOME/go 无需 sudo
• 版本过旧：APT 源可能滞后，建议改用官方压缩包或 GVM 安装所需版本
• 代理不可用：切换为可用镜像（如 https://goproxy.cn），或临时直连（direct）