Go 环境部署 (linux 和Windows 下的 GoLand )

[复制链接]
发表于 2026-10-3 21:52:27 | 显示全部楼层 |阅读模式

马上注册,结交更多好友,享用更多功能,让你轻松玩转社区。

您需要 登录 才可以下载或查看,没有账号?立即注册

×

Go 装起来其实就几步:下包、解压、加 PATH;真正耗时间的是后面那一串"为什么 go build 报找不到模块、为什么下载超时、为什么两个项目要两个版本"。本文按 Linux 与 Windows 两条线,把环境变量、模块代理、多版本管理、GoLand 配置一次讲顺。

Linux 下:下载与解压

下载地址:https://golang.google.cn/dl/,放到 linux 下的 /root/yjq 目录,执行:

wget https://golang.google.cn/dl/go1.18.linux-amd64.tar.gz
tar -zxvf go1.18.linux-amd64.tar.gz

在当前目录下会产生一个 go 目录。这里建议把包解压到 /usr/local/ 而不是当前目录,避免重建会话后路径失效。

配置环境变量

编辑用户的 bash 配置文件添加环境变量,打开bashrc文件:

vim ~/.bashrc

在此文件的末尾处,添加下面这句(路径换成你的解压位置):

export PATH=$PATH:/root/yjq/go/bin

最后刷新配置:

source ~/.bashrc

有可能会报错,需要手动再敲一遍 export PATH=$PATH:/root/yjq/go/bin 再验证。验证:

go version

模块管理:go.mod 时代不用配 GOROOT/GOPATH

如果项目是用 mod 管理,就不需要配置 GOROOT 和 GOPATH 了。但首先要确保 GO111MODULE 为 on,可以用命令查看:

go env GO111MODULE

假如不是 on 就设置为 on:

go env -w GO111MODULE=on

如果项目中还没有 go.mod 文件,可以用命令 go mod init 目录 就会自动生成 go.mod 文件。然后执行命令 go mod tidy。

go mod tidy 在项目开发过程中,如果有需要依赖新的第三方包,需要经常执行此命令(每次运行调试之前)下载所需要的依赖。假如下载出现 timeout,可以先设置一下代理:

export GOPROXY=https://goproxy.io

最好按这样设置(写入配置文件,在新的 shell 会话中永久生效):

go env -w GOPROXY=https://goproxy.io

然后再重新执行 go mod download 和 go mod tidy。

查看与更改 go 的环境变量

go env GOPATH
go env CGO_ENABLED
go env -json

go env -w GOPATH=/Users/ning/go
go env -w CGO_ENABLED=1

在 Go 中,go env -w 命令用于设置环境变量,-w 选项表示将设置的环境变量写入到当前的 shell 配置文件中,以便在新的 shell 会话中永久生效。因此 go env -w CGO_ENABLED=1 命令将设置 CGO_ENABLED 环境变量为 1,并写入配置文件,新会话里自动生效。

Windows 下:装 gcc

Windows 下安装 gcc,可以用 MinGW 或者 Cygwin。Cygwin 的网址是 https://www.cygwin.com/。装 gcc 是因为某些依赖(如依赖 C 扩展的包)需要本地编译工具链。

不同项目用不同版本的 go:GVM

# 安装 GVM:
bash < <(curl -s -S -L https://raw.githubusercontent.com/moovweb/gvm/master/binscript/gvm)
# 进入项目目录自动切换 Go 版本
cd path/to/your/project

gvm 会检查当前目录或其父目录中是否存在 .go-version 文件,如果存在,它会自动切换到该文件指定的 Go 版本。注意:确保项目目录中不要包含 go.mod 文件,否则 Go 会忽略 .go-version 文件,使用 go.mod 中指定的 Go 版本(实际测试,并没有忽略 .go-version)。

Windows 下使用 GoLand 工具

1、用 GoLand 工具下载 go 的 sdk

当然也可以手动从官网下载,下载后需要在 GoLand 中配置 GOROOT。重新进入 GoLand 工具后会看到 Setup GOROOT 入口,也可以从菜单 file → Settings 进入 Go → GOROOT 的设置。点击 Download,会弹出界面让你选择需要下载哪个版本的 sdk,选好后点击 OK,再点 Apply、OK,就可以下载 sdk。

2、GLOBAL GOPATH 与 Project GOPATH 的设置

由于现在的项目都开始用 go.mod 来管理项目了,所以 GLOBAL GOPATH 就不符合现在的项目管理了,就不用配置此值。配置了 Project GOPATH,GoLand 工具就会在此目录下查找 go.mod 文件,当然也可以不在此处配置;也可以在配置 Edit Configurations 的地方配置此信息,指定 Working directory 的路径(也就是 go.mod 所在的路径),系统也会自动找到 go.mod。

3、依赖的下载

在国内,有些依赖无法直接从国外站点下载,所以要配置一下国内的代理,比如 goproxy.io:

GOPROXY=https://goproxy.io

应用并重启:依次点击右下角的 Apply 和 OK 保存设置,并重启 GoLand 以使更改生效。

当你都配置完毕后,开始调试时发现许多依赖并不会自动去下载,可以采用下面的方法:用 GoLand 工具的终端,在项目工程路径下(也就是 go.mod 所在的路径下),执行命令 go mod tidy 即可(就开始下载了)。

小结

Linux 侧记住三步:下 tar 包 → 解压 → export PATH 加 source ~/.bashrc; Windows 侧在 GoLand 里 Download SDK 配上 GOROOT,然后 go mod tidy 拉依赖。代理一定要设(go env -w GOPROXY=...),否则国内下依赖必然 timeout。

两个长期经验:一是 mod 模式下 GOROOT/GOPATH 项目级配置基本可以不管,把 Working directory 指到 go.mod 所在目录,IDE 自己就找着了;二是多版本共存用 gvm + .go-version 比手动换包省心,切版本是自动的。另外 CGO_ENABLED 这类全局开关改之前先 go env -json 看一眼默认值,改坏了在 go env -w 反着设回去就行,不用动配置文件。

qidao123.com企服评测-应用市场 编辑提示:本文为站点编辑整理的 Go 环境部署与 GoLand 配置笔记,命令已按原意规范化书写;Go 版本与 SDK 请根据项目 go.mod 要求选择;本站不提供 Go 安装包或 IDE 下载,也不提供加好友服务。

回复

使用道具 举报

登录后关闭弹窗

登录参与点评抽奖  加入IT实名职场社区
去登录
快速回复 返回顶部 返回列表