快速入門

需求
安裝
開始使用

需求

Go 1.16 及更新版本

安裝

安裝 Gin 套件前, 你需要先安裝 Go 和準備好你的工作環境。

下載並安裝

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

在程式碼當中匯入套件

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

（可選的）如果你想要使用像是 http.StatusOK 的常數，你會需要匯入 net/http 套件

import "net/http"

使用 vendor 工具像是 Govendor

go get govendor

$ go get github.com/kardianos/govendor

新增你的專案資料夾並 cd 進入

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

Vendor init 專案並加入 gin

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

複製範本到你的專案

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

執行你的專案

$ go run main.go

開始使用

不確定如何寫和執行 Go 程式碼？ Click here.

第一步，新增一個檔案 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

最後修改 19.01.2023: chore: update Golang version requirement (#211) (1ba68a3)