Echo 系列教程——基础篇1:搭建 Echo 开发环境

工欲善其事必先利其器。我们先搞定 Echo 环境。

Go 开发环境

这个系列基于 Go1.14.4,Linux 系统。

安装 Go 的方式有很多,可以在这里 https://studygolang.com/dl 下载对应操作系统的版本。我自己比较喜欢通过源码安装。我将我的方式告诉大家。(Windows 环境比较建议直接下载对应的包进行安装 https://studygolang.com/dl/golang/go1.14.4.windows-amd64.msi

下载源码

在你本地某个目录(比如 $HOME/golang),执行如下命令(确保安装了 git):

git clone https://github.com/golang/go

因为 Go 自从 1.5 开始实现了自举,因此要从源码安装 1.5 或以后的版本,必须先有 Go 环境,也就是必须有 Go1.4 或以下版本,这里我们安装 Go1.4。

安装 Go1.4

执行如下命令进行安装:(需要有 root 权限)

$ git checkout -b release-branch.go1.4 origin/release-branch.go1.4
$ sudo cp -rf ../go /root/go1.4
$ sudo -s
$ cd /root/go1.4/src
$ ./make.bash

验证下 Go1.4 是否安装成功:

$ /root/go1.4/bin/go version

如果输出版本信息表示成功!

安装 Go1.14.4

接下来我们安装 Go1.14.4:(ctrl + d 切换回原用户)

$ cd ~/golang/go
$ git checkout -b release-branch.go1.14 origin/release-branch.go1.14
$ sudo cp -rf ../go /usr/local/go1.14
$ cd /usr/local/go1.14/src
$ sudo ./make.bash

然后我们加上一个软链,这样以后升级版本后,只需要重新设置软链即可:

$ sudo ln -s /usr/local/go1.14 /usr/local/go

配置 Go 环境

最后,将 Go 加入 PATH 中,Linux 中可以在 /etc/bashrc 文件最后加上 export PATH=$PATH:/usr/local/go/bin

MacOS 中可以在 ~/.bash_profile 中加上这行配置。

Windows 下的环境变量配置请自行查找解决,实在有问题可以咨询我!

之后,打开新的 shell,执行 go env 可以看到类似如下的输出(Linux 下):

GO111MODULE=""
GOARCH="amd64"
GOBIN=""
GOCACHE="/home/xuxinhua/.cache/go-build"
GOENV="/home/xuxinhua/.config/go/env"
GOEXE=""
GOFLAGS=""
GOHOSTARCH="amd64"
GOHOSTOS="linux"
GONOPROXY=""
GONOSUMDB=""
GOOS="linux"
GOPATH="/home/xuxinhua/go"
GOPRIVATE=""
GOPROXY="https://proxy.golang.org,direct"
GOROOT="/usr/local/go1.14"
GOSUMDB="sum.golang.org"
GOTMPDIR=""
GOTOOLDIR="/usr/local/go1.14/pkg/tool/linux_amd64"
GCCGO="gccgo"
AR="ar"
CC="gcc"
CXX="g++"
CGO_ENABLED="1"
GOMOD=""
CGO_CFLAGS="-g -O2"
CGO_CPPFLAGS=""
CGO_CXXFLAGS="-g -O2"
CGO_FFLAGS="-g -O2"
CGO_LDFLAGS="-g -O2"
PKG_CONFIG="pkg-config"
GOGCCFLAGS="-fPIC -m64 -pthread -fmessage-length=0 -fdebug-prefix-map=/tmp/go-build537145581=/tmp/go-build -gno-record-gcc-switches"

为了后续使用的顺畅,我们配置上 goproxy:

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

自此,我们的 Go 环境就搞定了!

升级 Go 版本

后续如果要升级 Go,分两种情况。

1)升级到 Go1.14.x,执行如下操作:

$ cd ~/golang/go
$ git pull
$ sudo rm -rf /usr/local/go1.14
$ sudo cp -rf ../go /usr/local/go1.14
$ cd /usr/local/go1.14/src
$ ./make.bash

2)将来升级到 Go1.15 及后续版本,执行类似如下操作(注意改分支信息和目录):

$ cd ~/golang/go
$ git pull
$ git checkout -b release-branch.go1.15 origin/release-branch.go1.15
$ sudo cp -rf ../go /usr/local/go1.15
$ cd /usr/local/go1.15/src
$ ./make.bash
$ ln -s /usr/local/go1.15 /usr/local/go

这样就搞定了!

另外,如果感兴趣也可以使用类似 gvm 这样的工具进行 Go 版本管理和切换。

开始 Echo

官方文档:https://echo.labstack.com/guide

中文翻译版:http://go-echo.org/

是什么?

High performance, extensible, minimalist Go web framework

Echo 是一个高性能、可扩展、极简的 Go Web 框架。

Hello World

所有的练习都在 ~/project/golang/studyecho 下进行。

$ mkdir -p ~/project/golang/studyecho
$ cd ~/project/golang/studyecho

接着初始化项目:

$ go mod init studyecho

这会在当前目录生成 go.mod 文件,内容如下:

module studyecho

go 1.14

安装 echo(我们使用 4.x.x):

$ go get -u github.com/labstack/echo/v4

这会在当前目录生成 go.sum 文件,同时修改 go.mod 文件。如果你对 Go module 不熟悉,建议阅读 Go Modules 的使用方法 —— Go 官方博文

创建文件 main.go:

package main

import (
	"net/http"
	// 注意这里的路径
	echo "github.com/labstack/echo/v4"
)

func main() {
  // 得到一个 echo.Echo 的实例
	e := echo.New()
  // 注册路由
	e.GET("/", func(c echo.Context) error {
		return c.String(http.StatusOK, "Hello, World!")
	})
  // 开启 HTTP Server
	e.Logger.Fatal(e.Start(":2020"))
}

启动服务:

$ go run main.go

终端输出:

打开浏览器,输入:http://localhost:2020 你会看到:Hello, World!

本节完~