快速入門
需求
- 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 getgovendor
$ 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/[email protected]
- 複製範本到你的專案
$ 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