gin框架 教程

gin 是一个使用 Go 语言编写的 Web 后端框架，具有简洁、轻量、支持高并发、封装优雅、API 友好、快速灵活、容错方便等特点。

gin 和 beego 是 Go 语言编写 Web 应用最常用的后端框架。

使用 Go 语言开发 Web 应用，对于框架的依赖要比其它编程语言要小。Go 语言内置的 net/http 包简单轻便，性能优良。而且，大多数的 Go 语言 Web 框架都是在其之上进行的封装。

官方网站：https://gin-gonic.github.io/gin/

Github地址：https://github.com/gin-gonic/gin

1. 为什么使用 gin 框架

框架是指半成品的应用，一般需要填充少许代码或者无需填充代码就可以运行，只是这样的应用缺少业务逻辑。

我们使用框架开发，主要工作就是在框架上补充业务逻辑代码。所以，借助框架进行开发，不仅可以减少开发时间、提高效率，也有助于团队统一编码风格，形成 编程规范。

gin 框架是一个 Web 框架，它封装了 路由、Cookie、Session、参数处理、数据编解码以及中间件等功能，简单高效，降低了开发 Web 应用的难度。

2. 安装 gin 框架

要安装 gin 框架软件包，您需要首先安装 Go，可以参考 Go 语言教程 章节的内容。

如果您使用了 Go 包管理工具来管理项目，那么通常不需要手动安装 gin，完全可以省略以下步骤，因为包管理工具会自动帮您下载安装，无需人工干预。比如使用包管理工具 go mod。

安装 gin 框架：

打开一个终端窗口（比如 Linux Shell 或者 Windows Cmd），运行以下命令。

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

3. 使用 gin 框架

使用 gin 框架也非常简单，将其导入代码中即可：

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

通常还需要导入 net/http 包，因为代码中一般需要一些常量，比如返回码 http.StatusOK。

import "net/http"

4. gin 框架使用范例

我们可以使用 gin，开发和运行 Web 应用 Hello World。

package main

import (
    "net/http"
    "github.com/gin-gonic/gin"
)

func main() {
   // 1.创建路由
   engine := gin.Default()
   // 2.绑定路由规则，执行的函数
   // gin.Context，封装了request和response
   engine.GET("/", func(c *gin.Context) {
      c.String(http.StatusOK, "Hello World!")
   })
   // 3.监听端口，默认在8080
   engine.Run(":8080")
}

打开浏览器，输入 http://localhost:8080，就可以看到浏览器输出 Hello World。