Golang学习01：Go安装和配置+Vscode、GoLand安装激活+Go环境变量避坑的超详细教程

🪁🍁 希望本文能给您带来帮助，如果有任何问题，欢迎批评指正！🐅🐾🍁🐥

---

一、背景

近年来，由于Go语言优秀的性能，不少互联网大小厂都开始热衷于使用Go语言进行服务器、云原生、网络编程等开发任务。随着Go的热潮的兴起，作者也是对Go语言颇有兴趣，因此，开一篇Go开发的专栏，记录一下学习过程并且分享一些学习经验。本篇文章将详细介绍Go语言的环境安装以及开发环境的安装步骤。

---

二、Go语言安装

2.1 Go语言环境安装

首先是Go语言环境的安装，由于Go语言官网下载速度比较慢，这里推荐大家使用Go语言中文网下载即可，而且Go语言官网和这个中文网发版基本同步。

大家可以自行根据系统来选择不同的版本，本文以Windows为例：

点击下载后，会在下载文件夹中出现上面选择的文件，由于文件属于安装包，还是需要解压安装的，这里直接双击即可呈现下图，然后选择Next：

然后勾选同意之后，继续选择Next：

然后再选择安装目录，默认安装目录是C盘，但是你懂的，我这里调整为E盘下面：

一直选择下一步，最后安装完成后应该呈现如下图：

2.2 Go语言环境验证

有过各种环境安装经验的朋友会知道，安装完之后需要在控制台进行验证一下，例如这里先Win + R唤醒运行窗口之后，输入cmd打开控制台窗口：

然后在控制台输入go version，可查看安装的go版本，检查其是否安装成功。

有朋友可能会有疑问，明明都没有配置环境变量，咋能直接使用go的命令？那是因为在高版本里安装时会默认在环境变量中配置，可以先Win + R唤醒运行窗口之后，输入sysdm.cpl打开环境变量，能够看到安装时就已经帮忙配置好了环境变量：

2.3 其他配置

在使用Go进行开发时，可能我们需要借用Go下载一些包什么的，但是默认官网源在国内访问不到，默认官网源如下：

https://proxy.golang.org,direct

因此，我们需要配置GOPROXY(代理)。在控制台输入go env，可查看go的初始环境配置，然后执行以下命令，进行修改代理，将其替换成国内镜像源。Windows 下设置 GOPROXY 的命令为：

go env -w GOPROXY=https://goproxy.cn,direct

MacOS 或 Linux 下设置 GOPROXY 的命令为：

export GOPROXY=https://goproxy.cn

重新执行go env查看Go配置，结果如下图：

---

三、开发环境搭建

Go语言开发使用各种编辑器都可以，比如vim、Sublim Text，但是这些开发工具不够智能，在这里，本文推荐使用GoLand或者Vscode去进行开发。

3.1 GoLand环境搭建

3.1.1 GoLand安装

接下来，我们去GoLand官网下载，安装步骤如下：

https://www.jetbrains.com.cn/go/

点击下载后，会在下载文件夹中出现对应的文件版本，由于文件属于安装包，还是需要解压安装的，这里直接双击即可呈现下图，然后选择下一步：

然后再选择安装目录，默认安装目录是C盘，但是你懂的，我这里调整为E盘下面的developtools目录下：

然后可以都勾选上，再点击下一步：

最后等待安装完成，重启电脑即可。

3.1.2 GoLand激活

由于GoLand是付费软件，因此要使用就需要付费或者科学的方式进行使用。当然这里直接跳跃到科学使用🧐：

方式一：直接使用激活码

76OEAYRJXK-eyJsaWNlbnNlSWQiOiI3Nk9FQVlSSlhLIiwibGljZW5zZWVOYW1lIjoi5rC45LmF5r+A5rS7IHd3d8K3YWppaHVvwrdjb20iLCJsaWNlbnNlZVR5cGUiOiJQRVJTT05BTCIsImFzc2lnbmVlTmFtZSI6IiIsImFzc2lnbmVlRW1haWwiOiIiLCJsaWNlbnNlUmVzdHJpY3Rpb24iOiIiLCJjaGVja0NvbmN1cnJlbnRVc2UiOmZhbHNlLCJwcm9kdWN0cyI6W3siY29kZSI6IkdPIiwicGFpZFVwVG8iOiIyMDI1LTAyLTIzIiwiZXh0ZW5kZWQiOmZhbHNlfSx7ImNvZGUiOiJSUzAiLCJwYWlkVXBUbyI6IjIwMjUtMDItMjMiLCJleHRlbmRlZCI6ZmFsc2V9LHsiY29kZSI6IkRNIiwicGFpZFVwVG8iOiIyMDI1LTAyLTIzIiwiZXh0ZW5kZWQiOmZhbHNlfSx7ImNvZGUiOiJDTCIsInBhaWRVcFRvIjoiMjAyNS0wMi0yMyIsImV4dGVuZGVkIjpmYWxzZX0seyJjb2RlIjoiUlNVIiwicGFpZFVwVG8iOiIyMDI1LTAyLTIzIiwiZXh0ZW5kZWQiOmZhbHNlfSx7ImNvZGUiOiJSU0MiLCJwYWlkVXBUbyI6IjIwMjUtMDItMjMiLCJleHRlbmRlZCI6dHJ1ZX0seyJjb2RlIjoiUEMiLCJwYWlkVXBUbyI6IjIwMjUtMDItMjMiLCJleHRlbmRlZCI6ZmFsc2V9LHsiY29kZSI6IkRTIiwicGFpZFVwVG8iOiIyMDI1LTAyLTIzIiwiZXh0ZW5kZWQiOmZhbHNlfSx7ImNvZGUiOiJSRCIsInBhaWRVcFRvIjoiMjAyNS0wMi0yMyIsImV4dGVuZGVkIjpmYWxzZX0seyJjb2RlIjoiUUEiLCJwYWlkVXBUbyI6IjIwMjUtMDItMjMiLCJleHRlbmRlZCI6ZmFsc2V9LHsiY29kZSI6IlJDIiwicGFpZFVwVG8iOiIyMDI1LTAyLTIzIiwiZXh0ZW5kZWQiOmZhbHNlfSx7ImNvZGUiOiJSU0YiLCJwYWlkVXBUbyI6IjIwMjUtMDItMjMiLCJleHRlbmRlZCI6dHJ1ZX0seyJjb2RlIjoiUk0iLCJwYWlkVXBUbyI6IjIwMjUtMDItMjMiLCJleHRlbmRlZCI6ZmFsc2V9LHsiY29kZSI6IklJIiwicGFpZFVwVG8iOiIyMDI1LTAyLTIzIiwiZXh0ZW5kZWQiOmZhbHNlfSx7ImNvZGUiOiJEUE4iLCJwYWlkVXBUbyI6IjIwMjUtMDItMjMiLCJleHRlbmRlZCI6ZmFsc2V9LHsiY29kZSI6IkRCIiwicGFpZFVwVG8iOiIyMDI1LTAyLTIzIiwiZXh0ZW5kZWQiOmZhbHNlfSx7ImNvZGUiOiJEQyIsInBhaWRVcFRvIjoiMjAyNS0wMi0yMyIsImV4dGVuZGVkIjpmYWxzZX0seyJjb2RlIjoiUFMiLCJwYWlkVXBUbyI6IjIwMjUtMDItMjMiLCJleHRlbmRlZCI6ZmFsc2V9LHsiY29kZSI6IlJSIiwicGFpZFVwVG8iOiIyMDI1LTAyLTIzIiwiZXh0ZW5kZWQiOmZhbHNlfSx7ImNvZGUiOiJSU1YiLCJwYWlkVXBUbyI6IjIwMjUtMDItMjMiLCJleHRlbmRlZCI6dHJ1ZX0seyJjb2RlIjoiV1MiLCJwYWlkVXBUbyI6IjIwMjUtMDItMjMiLCJleHRlbmRlZCI6ZmFsc2V9LHsiY29kZSI6IlBTSSIsInBhaWRVcFRvIjoiMjAyNS0wMi0yMyIsImV4dGVuZGVkIjp0cnVlfSx7ImNvZGUiOiJQQ1dNUCIsInBhaWRVcFRvIjoiMjAyNS0wMi0yMyIsImV4dGVuZGVkIjp0cnVlfSx7ImNvZGUiOiJBSUwiLCJwYWlkVXBUbyI6IjIwMjUtMDItMjMiLCJleHRlbmRlZCI6ZmFsc2V9LHsiY29kZSI6IlJTIiwicGFpZFVwVG8iOiIyMDI1LTAyLTIzIiwiZXh0ZW5kZWQiOnRydWV9LHsiY29kZSI6IkRQIiwicGFpZFVwVG8iOiIyMDI1LTAyLTIzIiwiZXh0ZW5kZWQiOnRydWV9LHsiY29kZSI6IlBEQiIsInBhaWRVcFRvIjoiMjAyNS0wMi0yMyIsImV4dGVuZGVkIjp0cnVlfSx7ImNvZGUiOiJQUlIiLCJwYWlkVXBUbyI6IjIwMjUtMDItMjMiLCJleHRlbmRlZCI6dHJ1ZX1dLCJtZXRhZGF0YSI6IjAyMjAyNTAxMjRQUEFNMDAwMDA1QSIsImhhc2giOiI2NTY4OTk0My8wOjE5MzY0ODQyNDEiLCJncmFjZVBlcmlvZERheXMiOjcsImF1dG9Qcm9sb25nYXRlZCI6ZmFsc2UsImlzQXV0b1Byb2xvbmdhdGVkIjpmYWxzZSwidHJpYWwiOmZhbHNlLCJhaUFsbG93ZWQiOnRydWV9-e+NaDZflm3hQBLA3VaFchg18w61XVe2i9j6Pi3yqsEG7nxzAQq2TpWQdh0KLszU6Z5qo+n0N7MTpA2Mw68sT665QsNrTaVQwAfrjDI5NZYPgFhstAd/KxMCnLfaJojX06caEx7tX+RIrTlDCN+W3p8D1urd4xG9+HB7vk7TaaY9DuJ5v+dLTTUROZFfNuEoPwmlRNZtBRJN3CMy6Qr0NGhmY9kumZJ6GY5T9a0JTIQFqARjPzSaNbfk+XsQhISSv+3uOaZGD//XbtGKHK0np9DdBOIgwnx892RzELAlMnu0BfluVOcJwo9brRB4nWScCp0jLMgXHYrheDCeuVfNw3A==-MIIETDCCAjSgAwIBAgIBETANBgkqhkiG9w0BAQsFADAYMRYwFAYDVQQDDA1KZXRQcm9maWxlIENBMB4XDTI0MDkyMDEyMTEyN1oXDTI2MDkyMjEyMTEyN1owHzEdMBsGA1UEAwwUcHJvZDJ5LWZyb20tMjAyNDA5MjAwggEiMA0GCSqGSIb3DQEBAQUAA4IBDwAwggEKAoIBAQC7SH/XcUoMwkDi8JJPzXWWHWFdOZdrP2Dqkz2W8iUi650cwz2vdPEd0tMzosLAj7ifkFEHUyiuEcL//q9d9Op7ZsV23lpPXX8tFMLFwugoQ9D8jDLT/XP9pp/YukWkKF5jpNbaCvsVQkDdYkArBkYvhH3aN4v9BkEsXahfgLLOPe4IG2FDJNf9R4to9V1vt+m2UVJB0zV4a/sVMKUZLgqKmKKKOKoLrE3OjBlZlb+Q0z2N5dsW0hDEVRFGmBUAbHN/mp44MMMvEIFKfoLIGpgic92P2O6uFh75PI7mcultL6yuR48ajErx8CjjQEGOSnoq/8hD+yVE+6GW2gJa2CPvAgMBAAGjgZkwgZYwCQYDVR0TBAIwADAdBgNVHQ4EFgQUb5NERj05GyNerQ/Mjm9XH8HXtLIwSAYDVR0jBEEwP4AUo562SGdCEjZBvW3gubSgUouX8bOhHKQaMBgxFjAUBgNVBAMMDUpldFByb2ZpbGUgQ0GCCQDSbLGDsoN54TATBgNVHSUEDDAKBggrBgEFBQcDATALBgNVHQ8EBAMCBaAwDQYJKoZIhvcNAQELBQADggIBALq6VfVUjmPI3N/w0RYoPGFYUieCfRO0zVvD1VYHDWsN3F9buVsdudhxEsUb8t7qZPkDKTOB6DB+apgt2ZdKwok8S0pwifwLfjHAhO3b+LUQaz/VmKQW8gTOS5kTVcpM0BY7UPF8cRBqxMsdUfm5ejYk93lBRPBAqntznDY+DNc9aXOldFiACyutB1/AIh7ikUYPbpEIPZirPdAahroVvfp2tr4BHgCrk9z0dVi0tk8AHE5t7Vk4OOaQRJzy3lST4Vv6Mc0+0z8lNa+Sc3SVL8CrRtnTAs7YpD4fpI5AFDtchNrgFalX+BZ9GLu4FDsshVI4neqV5Jd5zwWPnwRuKLxsCO/PB6wiBKzdapQBG+P9z74dQ0junol+tqxd7vUV/MFsR3VwVMTndyapIS+fMoe+ZR5g+y44R8C7fXyVE/geg+JXQKvRwS0C5UpnS5FcGk+61b0e4U7pwO20RlwhEFHLSaP61p2TaVGo/TQtT/fWmrtV+HegAv9P3X3Se+xIVtJzQsk8QrB/w52IB3FKiAKl/KRn1egbMIs4uoNAkqNZ9Ih2P1NpiQnONFmkiAgeynJ+0FPykKdJQbV3Mx44jkaHIif4aFReTsYX1WUBNu/QerZRjn4FVSHRaZPSR5Oi82Wz0Nj7IY9ocTpLnXFrqkb/Kt3S6B9s2Kol3Lr1ElYA

方式二：利用jetbra来进行破解

利用jetbra来进行破解的步骤可以参考此篇文章：《【Go】运行自己的第一个Go程序》。

3.2 Vscode环境搭建

3.2.1 Vscode安装

使用GoLand和Vscode去开发Go语言只能说各有千秋，GoLand是收费的，使用起来会更加重一点，但是不需要安装各种包，Vscode是免费的，会更加轻量级一点，但是需要安装一些包，大家自行感受即可🧐。

接下来直接来介绍如何去安装Vscode，我们先去Vscode官网下载，安装步骤如下：

https://code.visualstudio.com/

点击下载后，会在下载文件夹中出现对应的文件版本，由于文件属于安装包，还是需要解压安装的，这里直接双击即可呈现下图，先点击我同意，然后选择下一步：

然后再选择安装目录，默认安装目录是C盘，但是你懂的，我这里调整为E盘下面的developtools目录下：

然后再直接选择下一步：

全部勾选后，然后再直接选择下一步安装即可：

当出现如下图的进度条时说明程序已经正在安装了，最后跳出安装完成的界面就说明安装的步骤全部结束！

3.2.2 Go开发Vscode基本插件

由于上文对比Vscode和Goland已经提及到了Vscode明显的问题，要用Vscode运行go程序是需要安装一些扩展环境的，因此下文会介绍我们在使用Vscode会通常使用到的一些插件环境安装。

3.2.2.1 Vscode中文插件

首先市面上的大部分IDE工具都采用的是英文，因此如果有需求，可以将我们的Vscode改成中文版，这个微软官方是有提供相关插件的。
点击左侧菜单栏最后一项管理扩展，在搜索框中输入chinese ，选中结果列表第一项，点击install安装，安装后重启即可。

3.2.2.2 Go环境插件

微软针对于用Vscode进行Go语言的开发也是有提供对应的语言支持插件的，同样的点击左侧菜单栏最后一项管理扩展，在搜索框中输入Go ，选中结果列表第一项，点击install安装。

3.2.2.3 代码阅读定位插件Outline Map

Outline Map这个插件对于阅读代码源码，进行代码的方法或函数跟踪定位是非常方便的，推荐大家安装。

3.2.2.4 代码补全插件Golang postfix

Golang postfix这个插件对于写Go代码的时候比较方便，不仅有代码提示还有代码一键补全功能。

3.2.2.5 CodeRunner运行插件

我们除了在终端中go build xx和go run xx来运行代码，也可以利用工具来直接运行我们的代码，而不是通过终端的指令来运行。因此，可以添加插件：CodeRunner。

3.2.2.6 Go本身开发工具

有印象的朋友会记起来我们在安装Go语言环境那一节的时候提到了额外的配置，当时配置GOPROXY(代理)也就是为了此刻能够顺利下载扩展插件，不然由于墙的问题会导致一些扩展包下载失败。

3.2.2.7 F5命令快捷调试和运行

在上一个小节里利用CodeRunner引入的按钮可以运行go文件，但是需要时刻记得按下ctrl+s保存后再执行。除此之外，我们可以利用F5快捷键快速调试和运行，但是其依赖于dlv包，该包的安装方式依赖于命令：go install -v github.com/go-delve/delve/cmd/dlv@latest。

3.2.3 配置包目录说明

3.2.2章节里的 3.2.2.3 小节Go本身开发工具中有提示一些插件下载，那么那些通过go命令安装的插件文件存放到哪了呢？这一小节就来做个总结。首先在终端里输入go env命令可查看go相关环境变量，会发现GOPATH为用户家目录。

点进去这个家目录下的go文件夹里，我们会发现里面有两个包文件：

然后继续点进去bin目录里，我们会发现3个基本的可执行文件，下面将总结它们各自功能及命令安装方式，大家安装这3个扩展包基本就能方便的把go程序跑起来了，如果后来开发中有其他需要，可以自行利用go命令安装，最后都能在家目录下找到所下载的文件。

首先对这3个扩展包做总结：

文件名	作用	安装命令
dlv	go-delve是Go语言的调试利器	go install -v github.com/go-delve/delve/cmd/dlv@latest
gopls	官方提供的实现语言服务器协议LSP的Language Server，具有构建、格式化、自动完成等功能。	go install -v golang.org/x/tools/gopls@latest
staticcheck	静态代码检查作用	go install -v honnef.co/go/tools/cmd/staticcheck@latest

然后对这两个包目录做一下总结：

名称	作用
pkg目录	常用于缓存第三方包文件
bin目录	常用于存放可执行文件：通过go install命令下载的第三方包会放到$GOPATH/go下面的缓存目录，编译好的可执行文件会放到$GOPATH/go/bin下

最后对安装包的两个命令也做个总结：

名称	作用
go install命令	下载的第三方包会放到$GOPATH/go下面的缓存目录，编译好的可执行文件会放到$GOPATH/go/bin下
go get命令	下载第三方包会放到$GOPATH/go下面的缓存目录，但不会编译，只是为了后面编程用到这些包

3.3 可能遇到的问题

问题1： Go:1:1: expected ‘package‘, found ‘EOF‘原因及解决办法

解决方式： 如果你编写好代码后，运行后一直报Go:1:1: expected ‘package‘, found ‘EOF‘问题，原因大概率是：go项目文件没保存，直接ctrl+s快速保存即可解决。

---

四、入门案例HelloWorld

4.1 GoLand环境开发HelloWorld

经历过各种环境搭建之后，终于到了实战章节，本节将使用GoLand开发环境来实现一个输出Hello World的小案例。点击New Project新建项目，然后配置一下环境，就可以进行创建Hello World项目。

点击创建后，生成代码目录如下图：

其中会自动生成main文件，这里只需对其稍做修改，将其修改为Hello World打印代码，代码如下：

// 声明文件所在的包，每个go文件必须有归属的包
// 在go语言里，go语言的编译程序会试图把这种名字的包编译为可执行的文件。所有用Go语言编译的可执行程序都必须有一个叫main的包。
// 一个可执行程序有且仅有一个main包
package main// 引入程序所需要的包，例如这里打印需要使用fmt包
import "fmt"// main 主函数，程序的入口
func main() {// 控制台打印输出一句话，""里的内容会原样输出fmt.Println("Hello World")
}

然后点击绿色按钮运行，运行后效果如下图：

看到这，有朋友心里可能会有这样一个问题：它这怎么报红了呢？其实之前作者也是踩了这个坑了的，因为网上的资料也是良莠不齐，而且文章教程可能并没有随着Go语言版本更迭而更新，最终导致配置环境时可能出现莫名奇妙的问题。为了把这个点理清楚，下一节也会着重介绍一下Go的一些环境变量，然后把这个爆红的问题给解决掉，避免后续更多人踩坑😶。

4.2 Vscode环境开发HelloWorld

按照上文步骤配置过一些开发环境后再开发go代码就比较简单了，在工作目录下创建go文件，并编写Hello World打印代码：

然后再点击Vscode右上角的运行按钮即可，代码执行结果如下：

到这里就完成了Vscode打印hello world的代码，如果像上图中提示Go:1:1: expected ‘package‘, found ‘EOF‘，我们只需使用ctrl+s保存代码即可。

---

五、Go环境变量新手避坑

查看 go 的环境变量的命令为go env：

上面打印出来的环境变量有很多，但着重理解并记住这几个环境变量的定义即可：

变量名	解释
GOPATH	go 的工作目录
GOROOT	go 的安装目录
GOBIN	go 的bin文件目录
GO111MODULE	go mod 开关 on为开启go mod
GOPROXY	设置代理来加速模块下载

根据上一节打印Hello World的提醒来看是Go mod 和Go path冲突，因此，下面就着重介绍两者的差异。

5.1 GOPATH

GOPATH 是 Go语言中使用的一个环境变量，它使用绝对路径提供项目的工作目录。GOPATH是早期的设置方式，将工作目录设置 GOPATH 到全局环境变量。不同的项目都在 GOPATH/src/ 下。很显然这种设置方法是不太方便的，因为不同项目引用的 package 到放到了一起，这用 Git管理起来很麻烦。比如我们有这样一个场景：Ａ项目引用了 a和b 两个 package，B 项目引用了 c和d 两个 package，那么如果我在 A 中修改了 package 的内容，我提交Ａ项目时想要带着 package 时就很麻烦。其次是 如果Go语言所依赖的所有的第三方库都放在 GOPATH 这个目录下面，这就导致了同一个库只能保存一个版本的代码。如果不同的项目依赖同一个第三方的库的不同版本，应该怎么解决？

5.2 go module

那么为了解决上述问题，官方从从Go语言1.11 版本之后推出了版本管理工具go module ，并且从 Go语言1.13 版本开始，go module 成为了Go语言默认的依赖管理工具。在Go语言 1.12 版本之前，要启用 go module 工具首先要设置环境变量 GO111MODULE，不过在Go语言 1.13 及以后的版本则不再需要设置环境变量。通过 GO111MODULE 可以开启或关闭 go module 工具。

• GO111MODULE=off 禁用 go module，编译时会从 GOPATH 和 vendor 文件夹中查找包；
• GO111MODULE=on 启用 go module，编译时会忽略 GOPATH 和 vendor 文件夹，只根据 go.mod下载依赖；
• GO111MODULE=auto（默认值），当项目在 GOPATH/src 目录之外，并且项目根目录有 go.mod 文件时，开启 go module。

Windows 下开启 GO111MODULE 的命令为：

set GO111MODULE=on 或者 set GO111MODULE=auto

MacOS 或者 Linux 下开启 GO111MODULE 的命令为：

export GO111MODULE=on 或者 export GO111MODULE=auto

在开启 GO111MODULE 之后就可以使用 go module 工具了，也就是说在以后的开发中就没有必要在 GOPATH 中创建项目了，并且还能够很好的管理项目依赖的第三方包信息。这个时候也就清楚了上面为啥爆红了，因为环境变量GOPATH 设置了工作目录E:\goworkspace，当删除改系统环境变量设置后，再运行上文的Hello World代码，警告就消失了，执行效果如下图：

注意：现在新版本Go语言在配置环境变量时，只需要设置GOPROXY替换一下代理，无需再额外配置GOROOT、GOPATH。

---

六、总结

本文详细介绍了Go语言的环境安装以及各种开发环境的安装，希望本篇文章对您有所帮助。最后，希望您工作顺利，生活愉快！

---

七、参考资料

https://blog.csdn.net/weixin_45683778/article/details/144907111
https://c.biancheng.net/view/5712.html

---

创作不易，如果有帮助到你的话请给点个赞吧！我是Wasteland，下期文章再见！