如何快速准备一个易用的 Go 开发环境？

孔令飞原创约 6270 字大约 21 分钟实战营实战营

OneX 项目为了能够承载更多的开发技术，设计的相对复杂，这也直接提现在了安装的复杂性上。为了确保你能够顺利的安装 OneX，这里建议你参考本文，从零配置一个 Go 开发环境。当然，如果你是在已有的环境上安装，问题也不大，可能会有一些失败的步骤，但不多且可自行解决。

首先，这里首先分享下，学习一个开源项目最高效的学习步骤：

阅读 README，掌握项目的部署方式、功能列表、使用方式等；
克隆源码，本地编译构建，并启动服务，测试自己关注的功能点；
阅读（走读/精读）源码，根据需要修改源码，实现期望的效果，并重新编译测试。

上述步骤 2、3，需要你有一个适配项目开发语言的开发环境，对于 Go 项目来说，需要你有一个 Go 开发环境。为了最大化提高 Go 项目开发效率，开发环境需要是易用且高效的。

本文，我来介绍下，如何快速配置一个易用的开发环境。

为什么学习开源项目，要先从部署开始？

因为 OneX 部署分为了 4 节课，这里解释下为什么要详细介绍 OneX 项目的部署。

如果你想深入的学习一个开源项目，在阅读源码前，最好先部署好这个项目。先部署项目具有以下好处：

帮助理解： 对于新的技术，如果能运行起来，我们就可以通过操作和编写代码了解它如何工作，从而理解技术的工作原理和实现方式；
掌握实践技能： 搭建一个新的技术环境，需要学会一些具体的运维技能，例如 Linux 基本操作、Linux 常用的命令行工具、服务部署方法等。这些知识和内容，都是未来你必备的核心技能；
测试和调试： 搭建技术环境一般需要一定程度的调试和排错，这样不仅可以帮助我们带着一个全新的环境快速排错，并且培养了排错技能；
自定义和优化环境： 每个项目都有自己的要求，而搭建自己的环境更加贴合成长和研发目标，可以为你带来更好的开发体验，提升效率和能力。

总之，搭建一个新的技术环境可以加快我们熟悉这项技术的节奏，同时更好地理解技术原理与应用，这对于我们的学习、开发和实践都很有帮助。

如何快速准备好一个 Go 开发环境？

因为本课程是基于 Linux 进行开发、部署的，为了避免环境差异带来的问题，建议你也基于 Linux 系统进行部署。Go 的优势之一，是跨平台，所以如果你有 Mac、Windows 操作系统，理论上也可以顺利部署。只不过，你要自己根据理解进行部署。欢迎大家在评论区分享这些平台的部署教程。

如果你刚接触 Linux，建议你最好使用 Linux 进行开发部署，因为在使用 Linux 的同时，也是在学习 Linux，并且是带着需求去学习、实战，学习效率更高。

我们可以通过以下 3 步，来快速从 0 到 1 准备好一个 Go 开发环境：

Linux 服务器申请和配置；
Go 语言开发环境安装和配置；
Go 开发 IDE 安装和配置。

因为安装 vim、OneX 应用、执行 go get 命令等都会通过 Git 来下载安装包，所以我们还需要安装 Git。由于低版本的 Git 不支持 --unshallow 参数，而 go get 在安装 Go 包时会用到 git fetch --unshallow 命令，因此我们要确保安装一个高版本的 Git，这里我们安装当前最新的版本2.43.0（2024.01.08），具体的安装方法如下：

$ cd /tmp
$ wget --no-check-certificate https://mirrors.edge.kernel.org/pub/software/scm/git/git-2.43.0.tar.gz
$ tar -xvzf git-2.43.0.tar.gz
$ cd git-2.43.0/
$ ./configure
$ make
$ sudo make install
$ git --version # 输出 git 版本号，说明安装成功
git version 2.43.0

提示

国内因为众所周知的原因，访问国外网站网速会比较慢，请耐心等待。如果下载超时，可以多次重试尝试解决。

安装好 Git 后，还需要把 Git 的二进制目录添加到 PATH 路径中，不然 Git 可能会因为找不到一些命令导致 Git 报错。你可以执行以下命令来添加目录：

$ tee -a $HOME/.bashrc <<'EOF'
# Configure for git
export PATH=/usr/local/libexec/git-core:$PATH
EOF

配置 Git。

你可以直接执行以下命令来配置 Git：

$ git config --global user.name "孔令飞" # 用户名改成自己的
$ git config --global user.email "colin404@foxmail.com" # 邮箱改成自己的
$ git config --global credential.helper store # 设置 git，保存用户名和密码
$ git config --global core.longpaths true # 解决 Git 中 'Filename too long' 的错误

Go 语言开发环境安装和配置

Go 是一门编译型语言，需要使用 Go 语言编译器编译 Go 源码，生成二进制文件，并部署。所以首先需要安装 Go 编译器。

另外，在开发 Go 项目时，经常需要开发 RPC 服务，因此，还需要安装 Protobuf 编译器，来编译 Protobuf 文件。

所以，Go 语言开发环境的安装和配置包括以下 2 部分：

Go 编译环境安装和配置；
Protobuf 编译环境安装。

Go 编译环境安装和配置

安装 Go 的编译环境步骤比较简单，你只需下载源码包、设置相应的环境变量即可。具体步骤如下：

下载安装包。

可以从 Go 语言官方网站下载对应的 Go 安装包以及源码包，下面的命令会下载 go1.22.2 安装包：

$ wget -P /tmp/ https://go.dev/dl/go1.22.2.linux-amd64.tar.gz

解压并安装。

执行以下命令解压并安装 Go 编译工具和源码：

$ mkdir -p $HOME/go
$ tar -xvzf /tmp/go1.22.2.linux-amd64.tar.gz -C $HOME/go
$ mv $HOME/go/go $HOME/go/go1.22.2

配置 $HOME/.bashrc 文件。

你可以执行以下命令，将下列环境变量追加到 $HOME/.bashrc 文件中。

$ tee -a $HOME/.bashrc <<'EOF'
# Go envs
# Go version setting
export GOVERSION=go1.22.2
# Go installation directory
export GO_INSTALL_DIR=$HOME/go
# GOROOT setting
export GOROOT=$GO_INSTALL_DIR/$GOVERSION
# GOPATH setting
export GOPATH=$WORKSPACE/golang #
# Add the binaries from both the Go language and those installed via go install to the PATH
export PATH=$GOROOT/bin:$GOPATH/bin:$PATH
# Enable Go modules feature
export GO111MODULE="on"
# Proxy server setting for installing Go modules
export GOPROXY=https://goproxy.cn,direct
export GOPRIVATE=
# Turn off checking the hash value of Go dependency packages
export GOSUMDB=off
EOF

测试是否安装成功。

如果你执行 go version 命令可以成功输出 Go 的版本，就说明 Go 编译环境安装成功。具体命令如下：

$ bash # 配置 `$HOME/.bashrc` 后，需要执行 `bash` 命令将配置加载到当前 Shell
$ go version
go version go1.22.2 linux/amd64

Protobuf 编译环境安装

因为本实战项目还实现了一个 gRPC 服务器，gRPC 服务器使用 Protobuf 作为数据交换格式，所以我们还需要安装 Protobuf 文件的编译器 protoc。protoc 需要 protoc-gen-go 插件来完成 Go 语言的代码转换，因此我们需要安装 protoc 和 protoc-gen-go 这 2 个工具。它们的安装方法比较简单，具体分为以下两步：

安装 protoc 命令。

安装命令如下：

$ cd /tmp/
$ wget https://github.com/protocolbuffers/protobuf/releases/download/v25.1/protoc-25.1-linux-x86_64.zip
$ unzip protoc-25.1-linux-x86_64.zip -d protoc-25.1-linux-x86_64
$ sudo cp protoc-25.1-linux-x86_64/bin/protoc /usr/local/bin/
$ sudo cp -r protoc-25.1-linux-x86_64/include/ /usr/local/include/
$ protoc --version # 查看 protoc 版本，成功输出版本号，说明安装成功
libprotoc 25.1

提示

这里我们安装的 protoc 版本是 25.1。如果你安装了其他版本，后续执行 protoc 命令报错，可能需要你根据所安装的版本进行命令参数适配。

安装 protoc-gen-go 命令。

安装命令如下：

$ go install github.com/golang/protobuf/protoc-gen-go@latest

当你第一次执行 go install 命令的时候，因为本地无缓存，需要下载所有的依赖模块，所以安装速度会比较慢，请你耐心等待。

如果你感觉 go install 卡在那里，可以添加 -x 参数打印具体的安装细节，通过细节你可以发现具体哪个步骤执行时间比较久：

$ go install -x github.com/golang/protobuf/protoc-gen-go@latest

Go 开发 IDE 安装和配置

编译环境准备完之后，你还需要一个代码编辑器才能开始 Go 项目开发。为了提高开发效率，你还需要将这个编辑器配置成 Go IDE。

目前，GoLand、VSCode 这些 IDE 都很优秀，但它们都是 Windows 系统下的 IDE。在 Linux 系统下我们可以选择将 Vim 配置成 Go IDE。熟练 Vim IDE 操作之后，开发效率不输 GoLand 和 VSCode。有多种方法可以配置一个 Vim IDE，这里我选择使用 vim-goopen in new window 将 Vim 配置成一个 Go IDE。vim-go 是社区比较受欢迎的 Vim Go 开发插件，可以方便地将一个 Vim 配置成 Vim IDE。

提示

Linux 系统下还有 Emacs 编辑器值得你去使用。这里，我们有使用 Emacs，因为好久没用了，操作指令都忘了。使用哪款编辑器并不影响你学习本课程，根据自己的喜好来选择即可。

Vim IDE 的安装和配置分为以下两步：

安装最新版的 Vim：Vim 9；
配置 Vim IDE。

安装 Vim 9

如果你当前的 Linux 发行版，已经安装了 Vim 9，可跳过 Vim 9 的安装。如果没有安装 Vim 或者版本不是 9，建议升级到 Vim 9。安装命令如下：

$ git clone https://github.com/vim/vim /tmp/vim
$ cd /tmp/vim
$ sudo apt install -y libncurses5-dev
$ CFLAGS="-I/usr/local/include -fPIC" ./configure --prefix=/usr/local --with-features=huge --enable-cscope --enable-multibyte --enable-rubyinterp --enable-perlinterp --enable-python3interp --enable-luainterp --with-tlib=ncurses --without-local-dir
$ make
$ sudo make install
$ echo "alias vi=/usr/local/bin/vim" >> ~/.bash_aliases # 设置 vi 为最新的 vim 版本
$ bash

Vim IDE 安装和配置

上面，我们安装好了 Vim 编辑器。接下来，就可以安装 Vim IDE，具体安装命令如下：

$ rm -rf $HOME/.vim; mkdir -p ~/.vim/pack/plugins/start/
$ git clone https://github.com/colin404/vim-go ~/.vim/pack/plugins/start/vim-go
$ git clone https://github.com/VundleVim/Vundle.vim.git ~/.vim/bundle/Vundle.vim
$ git clone --depth=1 https://github.com/colin404/vimrc.git ~/.vim_runtime
$ sh ~/.vim_runtime/install_awesome_vimrc.sh
$ git clone https://github.com/superproj/vimrc /tmp/vimrc # 安装自定义 Vim 配置
$ cp /tmp/vimrc/vimrc $HOME/.vim_runtime/my_configs.vim

在之前使用 Vim 的过程中，发现依赖的仓库，例如：fatih/vim-go、amix/vimrc 最新版本会有一些 Bug 或环境不适配，导致 Vim IDE 配置失败。为了提高你的配置成功率，我 Fork 了一份稳定版本。上面安装配置，是从我 Fork 出来的（colin404/vim-go、colin404/vimrc）、经过验证（Debian 12）的代码仓库来安装的。当然，我会定期跟上游进行代码同步，确保 Fork 出来的代码仓库，功能上能跟最新的上游对齐。