快速入门

要求

  • Go 1.6 及以上版本

很快会需要 Go 1.8 版本.

安装

要安装 Gin 软件包,需要先安装 Go 并设置 Go 工作区。

1.下载并安装 gin:

    1. $ go get \-u github.com/gin\-gonic/gin

2.将 gin 引入到代码中:

    1. import "github.com/gin\-gonic/gin"

3.(可选)如果使用诸如 http.StatusOK 之类的常量,则需要引入 net/http 包:

    1. import "net/http"

使用 Govendor 工具创建项目

1.go get govendor

    1. $ go get github.com/kardianos/govendor

2.创建项目并且 cd 到项目目录中

    1. $ mkdir \-p $GOPATH/src/github.com/myusername/project && cd "$\_"

3.使用 govendor 初始化项目,并且引入 gin

    1. $ govendor init
    2. $ govendor fetch github.com/gin\-gonic/gin@v1.3

4.复制启动文件模板到项目目录中

    1. $ curl https://raw.githubusercontent.com/gin\-gonic/examples/master/basic/main.go > main.go

5.启动项目

    1. $ go run main.go

开始

不确定如何编写和执行 Go 代码? 点击这里.

首先,创建一个名为 example.go 的文件

    1. $ touch example.go

接下来, 将如下的代码写入 example.go 中:

    1. package main
    2. import "github.com/gin\-gonic/gin"
    3. func main() {
    4. r := gin.Default()
    5. r.GET("/ping", func(c \*gin.Context) {
    6. c.JSON(200, gin.H{
    7. "message": "pong",
    8. })
    9. })
    10. r.Run() // 监听并在 0.0.0.0:8080 上启动服务
    11. }

然后, 执行 go run example.go 命令来运行代码:

    1. # 运行 example.go 并且在浏览器中访问 0.0.0.0:8080/ping
    2. $ go run example.go