Logo
活死人の行知路

Go 开发环境搭建与配置指南


📅 | 📝 196 字
#go

1.安装 Go

1.1下载地址

1.2命令行安装 (Linux/macOS)

# 下载压缩包(以 1.23.3 为例)
wget https://golang.google.cn/dl/go1.23.3.linux-amd64.tar.gz

# 解压到 /usr/local (需要 sudo 权限)
sudo tar -C /usr/local -zxvf go1.23.3.linux-amd64.tar.gz

2.环境变量配置

在 Go Module 时代,我们不再需要像以前那样把代码死板地放在 GOPATH/src 下,但环境变量依然是核心。

2.1核心变量说明

变量名作用说明推荐配置
GOROOTGo 的安装目录/usr/local/go
GOPATH工作区目录。用于存放下载的第三方依赖包(pkg)和编译后的二进制文件(bin)$HOME/go
GOPROXY配置代理。加速国内下载第三方库https://goproxy.cn,direct
GOPRIVATE私有仓库。配置公司内部 Git 仓库,跳过代理和校验*.mycompany.com
PATH将 Go 的二进制程序目录加入系统查找路径需包含 GOROOT/binGOPATH/bin

2.2配置文件示例 (~/.zshrc~/.bashrc)

# Go 路径设置
export GOROOT=/usr/local/go
export GOPATH=$HOME/go

# 合并 PATH:以便直接运行 go 命令和通过 go install 安装的插件
export PATH=$PATH:$GOROOT/bin:$GOPATH/bin

# Go Module & Proxy 配置
export GO111MODULE=on
export GOPROXY=goproxy.cn,goproxy.io,direct
# export GOPRIVATE=gitlab.example.com

注意: 修改完配置文件后,记得执行 source ~/.zshrc (或对应的配置文件)使其立即生效。


3.验证

# 1. 查看版本
go version

# 2. 查看详细环境配置
go env

4.现代管理技巧

4.1开启 Go Module (必做)

现在的 Go 项目不再推荐在 GOPATH/src 下开发。请确保开启 Module 模式:

go env -w GO111MODULE=on

4.2多版本共存与管理

如果你需要同时测试不同版本的 Go(例如遗留项目用 1.14,新项目用 1.23),官方提供了非常优雅的方案:

# 安装特定版本管理器
go install golang.org/dl/go1.23.3@latest

# 下载对应版本的 SDK
go1.23.3 download

# 使用该版本执行命令
go1.23.3 version

提示: 安装后的 SDK 源码通常存放在 $HOME/sdk/ 目录下。


5.卸载 Go

如果你是通过解压方式安装的,卸载非常简单:

# 1. 删除安装目录
sudo rm -rf /usr/local/go

# 2. 清理环境变量 
# (手动编辑 ~/.zshrc 或 ~/.bashrc,删除之前添加的 Go 相关的 export 语句)

6.💡 开发建议

  • IDE 选择: 推荐使用 VS Code (配合 Go 扩展) 或 JetBrains GoLand
  • 关于 GOPATH: 现在的 GOPATH 更多是作为“缓存库”存在。你可以把代码放在电脑的任何地方(如 ~/Desktop/my-project),只要目录下有 go.mod 文件即可。