backend_development_environment_preparation.md

如何搭建后端开发环境

安装开发工具

需要安装的软件有：

• Git
• Visual Studio Code
• Goland
• Docker
• Go
• protobuf-compiler
• Make
• Buf
• gawk
• grep
• sed

Windows

Windows下安装软件的方法有很多种，这里推荐使用软件包管理工具：scoop。

一键安装所有的开发软件：

scoop bucket add extras
scoop install git vscode goland docker go protobuf make buf gawk grep sed

MacOS

MacOS下安装软件的方法有很多种，这里推荐使用软件包管理工具：Homebrew。

brew install git docker go protobuf make buf gawk grep gnu-sed
brew install --cask visual-studio-code goland

安装插件

后端需要的插件主要是Protobuf的插件：

• protoc-gen-go
• protoc-gen-go-grpc
• protoc-gen-go-http
• protoc-gen-go-errors
• protoc-gen-openapi
• protoc-gen-validate

安装方法：

go install google.golang.org/protobuf/cmd/protoc-gen-go@latest
go install google.golang.org/grpc/cmd/protoc-gen-go-grpc@latest
go install github.com/go-kratos/kratos/cmd/protoc-gen-go-http/v2@latest
go install github.com/go-kratos/kratos/cmd/protoc-gen-go-errors/v2@latest
go install github.com/google/gnostic/cmd/protoc-gen-openapi@latest
go install github.com/envoyproxy/protoc-gen-validate@latest

或者你可以在项目的根目录下执行make，该命令会把前后端的插件都装好的：

make plugin

Golang设置网络代理

打开模块支持

go env -w GO111MODULE=on

取消代理

go env -w GOPROXY=direct

取消校验

go env -w GOSUMDB=off

设置不走 proxy 的私有仓库或组，多个用逗号相隔（可选）

go env -w GOPRIVATE=git.mycompany.com,github.com/my/private

设置代理

国内常用代理列表

提供者	地址
官方全球代理	https://proxy.golang.com.cn
七牛云	https://goproxy.cn
阿里云	https://mirrors.aliyun.com/goproxy/
GoCenter	https://gocenter.io
百度	https://goproxy.bj.bcebos.com/

“direct” 为特殊指示符，用于指示 Go 回源到模块版本的源地址去抓取(比如 GitHub 等)，当值列表中上一个 Go module proxy 返回 404 或 410 错误时，Go 自动尝试列表中的下一个，遇见 “direct” 时回源，遇见 EOF 时终止并抛出类似 “invalid version: unknown revision...” 的错误。

官方全球代理

go env -w GOPROXY=https://proxy.golang.com.cn,direct
go env -w GOSUMDB=sum.golang.google.cn

或者

go env -w GOPROXY=https://goproxy.io,direct
go env -w GOSUMDB=gosum.io+ce6e7565+AY5qEHUk/qmHc5btzW45JVoENfazw8LielDsaI+lEbq6

七牛云

go env -w GOPROXY=https://goproxy.cn,direct
go env -w GOSUMDB=goproxy.cn/sumdb/sum.golang.org

阿里云

go env -w GOPROXY=https://mirrors.aliyun.com/goproxy/,direct
# GOSUMDB 不支持

GoCenter

go env -w GOPROXY=https://gocenter.io,direct
# 不支持 GOSUMDB

百度

go env -w GOPROXY=https://goproxy.bj.bcebos.com/,direct
# 不支持 GOSUMDB

warning: go env -w GOPROXY=... does not override conflicting OS environment variable

原因：

之前安装go的时候，用环境变量的方式设置过代理地址，go13提供了-w参数来设置GOPROXY变量，但无法覆盖OS级别的环境变量

解决方法：

unset GOPROXY

# or 

Clear-Variable GOPROXY

IDE 插件安装

后端开发需要安装Buf的插件，否则，通过Buf引用的第三方proto，IDE会无法解析。

• VSC
• Goland