01 框架安装

优质
小牛编辑
133浏览
2023-12-01

概述

看下 Gin 框架的官方介绍:

Gin 是一个用 Go (Golang) 编写的 web 框架。 它是一个类似于 martini 但拥有更好性能的 API 框架, 由于 httprouter,速度提高了近 40 倍。 如果你是性能和高效的追求者, 你会爱上 Gin。

是的,就是用 Gin 来写 API 接口。

Gin 安装

必须要先安装 Go,Go 的安装可以参考:Go - 环境安装

框架安装可以参考官网:

https://gin-gonic.com/zh-cn/docs/quickstart/

我在安装时,用的是 dep 安装,给大家分享下。

dep 是啥 ?

它是 Golang 官方依赖管理工具,可以认为它与 PHP 中的 composer 类似。

在这就不多做介绍了,可以自己去了解,安装也比较简单。

我本机是 Mac,安装只需一个命令:

brew install dep

咱们接下来创建一个新项目:ginDemo。

在 ginDemo 目录下执行:

dep init

执行完毕,会生成如下三个文件:

├─ ginDemo
│  ├─ vendor
│  ├─ Gopkg.toml
│  ├─ Gopkg.lock
  • 依赖包都会下载到 vendor 目录。
  • 需要的依赖配置写在 Gopkg.toml 文件。
  • Gopkg.lock 暂时可以不用管。

Gopkg.toml 文件中增加依赖:

[[constraint]]
  name = "github.com/gin-gonic/gin"
  version = "1.4.0"

新增一个 main.go 文件:

// 官方 Demo
package main

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

func main() {
    r := gin.Default()
    r.GET("/ping", func(c *gin.Context) {
        c.JSON(200, gin.H{
            "message": "pong",
        })
    })
    r.Run() // listen and serve on 0.0.0.0:8080
}

ginDemo 目录下执行:

dep ensure

执行完毕,vendor 目录会存在安装包,这时整体目录结构如下:

├─ ginDemo
│  ├─ vendor
│     ├── github.com
│         ├── ...
│     ├── golang.org
│         ├── ...
│     ├── gopkg.in
│         ├── ...
│  ├─ Gopkg.toml
│  ├─ Gopkg.lock
│  ├─ main.go

ginDemo 目录下执行:

go run main.go

浏览器访问:http://localhost:8080/ping

大功告成!