Быстрый старт

В этом кратком руководстве мы извлечем уроки из сегментов кода и узнаем, как:

Требования

Go 1.16 или выше

Установка

Чтобы установить пакет Gin, необходимо сначала установить Go и настроить рабочее пространство Go.

Скачайте и установите его:

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

Импортируйте его в свой код:

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

(Необязательно) Импортируйте net/http. Это необходимо, например, при использовании таких констант, как http.StatusOK.

import "net/http"

Создайте папку проекта и cd в ней

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

Скопируйте начальный шаблон в свой проект

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

Запустите свой проект

$ go run main.go

Начало работы

Не знаете, как написать и выполнить код Go? Нажмите здесь.

Сначала создайте файл с именем example.go:

# assume the following codes in example.go file
$ touch example.go

Затем поместите следующий код в файл example.go:

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
}

И вы можете запустить код с помощью go run example.go:

# run example.go and visit 0.0.0.0:8080/ping on browser
$ go run example.go