实践是最好的学习方式

零基础通过开发Web服务学习Go语言

本文适合有一定编程基础，但是没有Go语言基础的同学。

也就是俗称的“骗你”学Go语言系列。

这是一个适合阅读的系列，我希望您能够在车上、厕所、餐厅都阅读它，涉及代码的部分也是精简而实用的。

学习需要动机

Go语言能干什么？为什么要学习Go语言？

本系列文章，将会以编程开发中需求最大、应用最广的Web开发为例，一步一步的学习Go语言。当看完本系列，您能够清晰的了解Go语言Web开发的基本原理，您会惊叹于Go语言的简洁、高效和新鲜。

结果反馈才能让你记住

《刻意练习》一书中说，学习需要及时反馈结果，才能提高学习体验。

本系列文章的每一节，都会包含一段可运行的有效代码，跟着内容一步一步操作，你可以在你自己的计算机上体验每一句代码的作用。

不要学习不需要的东西

文章围绕范例为核心，介绍知识点。文中不罗列语法和关键字，当您还不知道它们用来干什么时，反而会干扰您的注意力。

希望您在阅读本系列文章后，对Go语言产生更多的学习欲望，成为一名合格的Gopher

Gopher:原译是囊地鼠，也就是Go语言Logo的那个小可爱；这里特指Go程序员给自己的昵称。

如何10分钟搭建Go开发环境

1.下载Go语言安装文件

访问Go语言官方网站下载页面:

可以看到官网提供了Microsoft Windows、Apple MacOS、Linux和Source下载。

直接下载对应操作系统的安装包。

2.和其他软件一样，根据提示安装

3.配置环境变量

在正式使用Go编写代码之前，还有一个重要的“环境变量”需要配置：“$GOPATH”

GOPATH环境变量指定工作区的位置。如果没有设置GOPATH，则假定在Unix系统上为$HOME/go，在Windows上为 %USERPROFILE%\go。如果要将自定义位置用作工作空间，可以设置GOPATH环境变量。

GOPATH环境变量是用于设置Go编译可以执行文件、包源码以及依赖包所必要的工作目录路径，Go1.11后，新的木块管理虽然可以不再依赖 $GOPATH/src，但是依然需要使用 $GOPATH/pkg 路径来保存依赖包。

首先，创建好一个目录用作GOPATH目录

然后设置环境变量 GOPATH:

Linux & MacOS:

导入环境变量

$ export GOPATH=$YOUR_PATH/go

保存环境变量

$ source ~/.bash_profile

Windows:

控制面板->系统->高级系统设置->高级->环境变量设置

$GOPATH设置好后，它是一个空目录，当在开发工作中执行go get、go install命令后， $GOPATH所指定的目录会生成3个子目录：

bin：存放 go install 编译的可执行二进制文件

pkg：存放 go install 编译后的包文件，就会存放在这里

src：存放 go get 命令下载的源码包文件

4.检查环境

打开命令行工具，运行

$ go env

如果你看到类似这样的结果，说明Go语言环境安装完成.

GOARCH="amd64"

GOBIN=""

GOCACHE="/Users/zeta/Library/Caches/go-build"

GOEXE=""

GOFLAGS=""

GOHOSTARCH="amd64"

GOHOSTOS="darwin"

GOOS="darwin"

GOPATH="/Users/zeta/workspace/go"

GOPROXY="https://goproxy.io"

GORACE=""

GOROOT="/usr/local/go"

GOTMPDIR=""

GOTOOLDIR="/usr/local/go/pkg/tool/darwin_amd64"

GCCGO="gccgo"

CC="clang"

CXX="clang++"

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 -fno-caret-diagnostics -Qunused-arguments -fmessage-length=0 -fdebug-prefix-map=/var/folders/7v/omg2000000000000019/T/go-build760324613=/tmp/go-build -gno-record-gcc-switches -fno-common"

5.选择一款趁手的编辑器或IDE

现在很多通用的编辑器或IDE都支持Go语言比如

Go语言专用的IDE有

专用的IDE无论是配置和使用都比通用编辑器/IDE的简单许多，但是我还是推荐大家使用通用编辑器/IDE，因为在开发过程中肯定会需要编写一些其他语言的程序或脚本，专用IDE在其他语言编写方面较弱，来回切换不同的编辑器/IDE窗口会很低效。

另外，专用IDE提供很多高效的工具，在编译、调试方面都很方便，但是学习阶段，建议大家手动执行命令编译、调试，有利于掌握Go语言。

四行代码的Hello World！所能表达出来的核心

命令行代码仅适用于Linux和MacOS系统，Windows根据说明在视窗下操作即可。

1.创建项目

创建一个文件夹，进入该文件夹

$ mkdir gowebserver && cd gowebserver

新建一个文件 main.go

$ touch main.go

2. 用编辑器打开文件，并输入以下代码：

package main

import "fmt"

func main() {

fmt.Println("Hello, 世界")

}

3.打开命令行终端，输入以下命令

$ go run main.go

看到终端会输出：

Hello, 世界

第一个Go代码就完成了

这是一个很简单的Hello World，但是包含了Go语言编程的许多核心元素，接下来就详细讲解。

解读知识点: 包 与 函数

package申明包 & import导入包

Go程序是由包构成的。

代码的第一行, 申明程序自己的包，用 package 关键字。package关键字必须是第一行出现的代码。

范例代码中，申明的本包名 main

在代码中第二行, 导入“fmt”包, 使用 import 关键字。默认情况下，导入包的包名与导入路径的最后一个元素一致，例如 import "math/rand"，在代码中使用这个包时，直接使用rand，例如 rand.New()

导入包的写法可以多行,也可以“分组”, 例如:

import "fmt"

import "math/rand"

或者 分组

import (

"fmt"

"math/rand"

)

fmt包是Go语言内建的包,作用是输出打印。

func关键字：定义函数

func是function的缩写, 在Go语言中是定义函数的关键字。

func定义函数的格式为：

func 函数名(参数1 类型,参数2 类型){

函数体

}

本例中定义了一个main函数。main函数没有参数。

然后在main函数体里调用fmt包的Println函数，在控制台输出字符串 “Hello, 世界”

所有Go语言的程序的入口都是main包下的main函数 main.main()，所以每一个可执行的Go程序都应该有一个main包和一个main函数。

我们已经介绍了九牛一毛中的一毛，接下来正式通过搭建一个简单的Web服务学习Go语言

0依赖，创建一个Web服务

先从代码开始

打开之前创建好的main.go文件，修改代码如下:

package main

import (

"fmt"

"net/http"

)

func myWeb(w http.ResponseWriter, r *http.Request) {

fmt.Fprintf(w, "这是一个开始")

}

func main() {

http.HandleFunc("/", myWeb)

fmt.Println("服务器即将开启，访问地址 http://localhost:8080")

err := http.ListenAndServe(":8080", nil)

if err != nil {

fmt.Println("服务器开启错误: ", err)

}

}

保存文件，然后在命令行工具下输入命令，运行程序

$ go run main.go

这时候，你会看到用 fmt.Println打印出来的提示，在浏览器中访问 http://localhost:8080你将访问到一个页面，显示 "这是一个开始"

解读

我们从程序运行的顺序去了解它的工作流程

首先，定义package main，然后导入包。

这里，导入了一个新的包 net/http，这个包是官方的，实现http客户端和服务端的各种功能。Go语言开发Web服务的所有功能就是基于这个包(其他第三方的Go语言Web框架也都基于这个包，没有例外)

先看main函数里发生了什么

第一句，匹配路由和处理函数

http.HandleFunc("/", myWeb)

调用http包的HandleFunc方法，匹配一个路由到一个处理函数myWeb。

这句代码的意思是，当通过访问地址 http://localhost/ 时，就等同于调用了 myWeb 函数。

第二句，用fmt在控制台打印一句话，纯属提示。

第三句，开启服务并且监听端口

err := http.ListenAndServe(":8080", nil)

在这句，调用了http包中的ListenAndServe函数，该函数有两个参数，第一个是指定监听的端口号，第二个是指定处理请求的handler，通常这个参数填nil，表示使用默认的ServeMux作为handler。

什么是nil？

nil就是其他语言里的null。

什么是handler?什么是ServeMux？

ServeMux就是一个HTTP请求多路由复用器。它将每个传入请求的URL与已注册模式的列表进行匹配，并调用与URL最匹配的模式的处理程序。

很熟悉吧？还记得前面的http.HandleFunc吗？他就是给http包中默认的ServeMux(DefaultServeMux)添加URL与处理函数匹配。

通常都是使用http包中的默认ServeMux，所以在http.ListenAndServe函数的第二个参数提供nil就可以了

ListenAndServe函数会一直监听，除非强制退出或者出现错误。

如果这句开启监听出现错误，函数会退出监听并会返回一个error类型的对象，因此用err变量接收返回对象。紧接着，判断err是否为空，打印出错误内容，程序结束。

这里有两个Go语言知识点

1.定义变量

Go语言是静态语言，需要定义变量，定义变量用关键字var

var str string = "my string"

//^ ^ ^

//关键字 变量名 类型

Go还提了一种简单的变量定义方式:=，自动根据赋值的对象定义变量类型，用起来很像脚本语言：

str := "my string"

2.错误处理

if err != nil{

//处理....

}

在Go语言中，这是很常见的错误处理操作，另一种panic异常，官方建议不要使用或尽量少用，暂不做介绍，先从err开始。

Go语言中规定，如果函数可能出现错误，应该返回一个error对象，这个对象至少包含一个Error()方法错误信息。

因此，在Go中，是看不到try/catch语句的，函数使用error传递错误，用if语句判断错误对象并且处理错误。

3. if 语句

与大多数语言使用方式一样，唯一的区别是，表达式不需要()包起来。

另外，Go语言中的if可以嵌入一个表达式，用;号隔开，例如范例中的代码可以改为：

if err := http.ListenAndServe(":8080", nil); err != nil {

fmt.Println("服务器开启错误: ", err)

}

err这个变量的生命周期只在if块中有效。

请求处理 myWeb函数

在main函数中，用http.HandleFunc将 myWeb与路由/匹配在一起。

HandleFunc函数定义了两个参数w,r，参数类型分别是http.ResponseWriter和*http.Request，w是响应留写入器，r是请求对象的指针。

响应流写入器 w: 用来写入http响应数据

请求对象 * r: 包含了http请求所有信息，注意，这里使用了指针，在定义参数时用*标记类型，说明这个参数需要的是这个类型的对象的指针。

当有请求路径/，请求对象和响应流写入器被传递给myWeb函数，并由myWeb函数负责处理这次请求。

Go语言中红的指针： 在Go语言中 除了map、slice、chan 其他函数传参都是值传递，所以，如果需要达到引用传递的效果，通过传递对象的指针实现。在Go语言中，取对象的指针用&，取值用*，例如：

mystring := "hi"

//取指针

mypointer := &mystring

//取值

mystring2 := *mypointer

fmt.Println(mystring,mypointer,mystring2)

把这些代码放在main函数里，$ go run main.go运行看看

myWeb函数体

fmt.Fprintf(w, "这是一个开始")

再一次遇到老熟人fmt，这次使用他的Fprintf函数将字符串“这是一个开始”,写入到w响应流写入器对象。w响应流写入器里写入的内容最后会被Response输出到用户浏览器的页面上。

总结一下，从编码到运行，你和它都干了些什么：

定义一个函数myWeb，接收参数 响应流写入器和请求对象两个参数

在main函数中，在默认的ServeMux中将路由/与myWeb绑定

运行默认的ServeMux监听本地8080端口

访问本地8080端口 / 路由

http将请求对象和响应写入器都传递给myWeb处理

myWeb向响应流中写入一句话，结束这次请求。

虽然代码很少很少，但是这就是一个最基本的Go语言Web服务程序了。

Web互动第一步，Go http 获得请求参数

还是先从代码开始

打开main.go文件，修改myWeb函数，如下:

func myWeb(w http.ResponseWriter, r *http.Request) {

r.ParseForm() //它还将请求主体解析为表单，获得POST Form表单数据，必须先调用这个函数

for k, v := range r.URL.Query() {

fmt.Println("key:", k, ", value:", v[0])

}

for k, v := range r.PostForm {

fmt.Println("key:", k, ", value:", v[0])

}

fmt.Fprintln(w, "这是一个开始")

}

运行程序

$ go run main.go

然后用任何工具(推荐Postman)提交一个POST请求，并且带上URL参数，或者在命令行中用cURL提交

curl --request POST \

--url 'http://localhost:8080/?name=zeta' \

--header 'cache-control: no-cache' \

--header 'content-type: application/x-www-form-urlencoded' \

--data description=hello

页面和终端命令行工具会答应出以下内容：

key: name , value: zeta

key: description , value: hello

解读

http请求的所有内容，都保存在http.Request对象中，也就是myWeb获得的参数 r 。

首先，调用r.ParseForm()，作用是填充数据到 r.Form 和 r.PostForm

接下来，分别循环获取遍历打印出 r.URL.Query() 函数返回的值 和 r.PostForm 值里的每一个参数。

r.URL.Query() 和 r.PostForm 分别是URL参数对象和表单参数对象

，它们都是键值对值，键的类型是字符串string，值的类型是string数组。

在http协议中，无论URL和表单，相同名称的参数会组成数组。

循环遍历：for...range

Go语言的循环只有for关键字，以下是Go中4种for循环

//无限循环，阻塞线程，用不停息，慎用！

for{

}

//条件循环，如果a

for a < b{

}

//表达式循环，设i为0，i小于10时循环，每轮循环后i增加1

for i:=0; i<10; i++{

}

//for...range 遍历objs，objs必须是map、slice、chan类型

for k, v := range objs{

}

前3种，循环你可以看作条件循环的变体(无限循环就是无条件的循环)。

本例种用到的是 for...range 循环，遍历可遍历对象，并且每轮循环都会将键和值分别赋值给变量 k 和 v

我们页面还是只是输出一句“这是一个开始”。我们需要一个可以见人的页面，这样可以不行

你也许也想到了，是不是可以在输出时，硬编码HTML字符串？当然可以，但是Go http包提供了更好的方式，HTML模版。

接下来，我们就用HTML模版做一个真正的页面出来

动态响应数据给访客，Go http HTML模版+数据绑定

读取HTML模版文件，用数据替换掉对应的标签，生成完整的HTML字符串，响应给浏览器，这是所有Web开发框架的常规操作。Go也是这么干的。

Go html包提供了这样的功能：

"html/template"

从代码开始

main函数不变，增加导入html/template包，然后修改myWeb函数，如下：

import (

"fmt"

"net/http"

"text/template" //导入模版包

)

func myWeb(w http.ResponseWriter, r *http.Request) {

t := template.New("index")

t.Parse("

")

data := map[string]string{

"name": "zeta",

"someStr": "这是一个开始",

}

t.Execute(w, data)

// fmt.Fprintln(w, "这是一个开始")

}

在命令行中运行 $ go run main.go ，访问 http://localhost:8080

看，

中的{{.name}}和{{.someStr}} 被替换成了 zeta和这是一个开始。并且，不再使用fmt.Fprintln函数输出数据到Response了

但是...这还是在代码里硬编码HTML字符串啊...

别着急，template包可以解析文件，继续修改代码：

根目录下创建一个子目录存放模版文件 templates, 然后进入目录创建一个文件 index.html，并写入一些HTML代码 (我不是个好前端)

修改myWeb函数

func myWeb(w http.ResponseWriter, r *http.Request) {

//t := template.New("index")

//t.Parse("