前端程式設計師學習 Golang gin 框架實戰筆記之一開始玩 gin

原文連結

我是一名五六年經驗的前端程式設計師，現在準備學習一下 Golang 的後端框架 gin。

以下是我的學習實戰經驗，記錄下來，供大家參考。

https://github.com/gin-gonic/gin

1. 先安裝 Golang

我使用蘋果系統，很簡單，用以下命令：

brew install golang

其他系統的朋友在這裡下載安裝包即可：https://go.dev/dl/

要驗證是否安裝成功，只需要進入命令列如下：

$ go version
go version go1.19.1 darwin/amd64

能得到版本號即可。

2. 初始化專案

你找一個空目錄，或新增一個。

mkdir go-rest-api

用命令列進入它。

cd go-rest-api

初始化：

go mod init go-rest-api

go-rest-api 就是專案名稱，一般我們自己的專案，類似這樣命令就可以了，如果是開源庫，你可以在前面加上域名。

比如: github.com/gin-gonic/gin

或者用你公司的域名，加上專案名，比如 example.com/go-rest-api

這條初始化命令就生成了一個檔案，如下：

go.mod

module go-rest-api

go 1.19

模組 module 名，就是我們的專案名 go-rest-api

還有 golang 的版本號 1.19。

建立專案入口檔案

接下來建立入口檔案：main.go

這裡我推薦 vscode 或 GoLand 編輯器來編寫程式碼。

package main

import (
	"fmt"
)

func main() {
	fmt.Println("Hello World!")
}

這個很簡單，入口的包名叫 main，一般我們不需要去動它。

fmt 是標準庫提供的用於輸出的。

然後一個函數，輸出 Hello World!

3. 執行專案

在命令列執行命令：

go run main.go

終端會輸出：

Hello World!

4. 安裝 gin 框架

找到 gin 框架的 github 地址：

https://github.com/gin-gonic/gin

golang 安裝庫或框架很簡單，只需要一條命令：

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

get 表示安裝，-u 表示安裝最新的包。

不加 -u 也行。

安裝完之後，並不會在本地專案下載包的原始碼，這些原始碼會被放到本地別的地方去，也會被其他專案共用，而不是每個專案都複製一份包的原始碼。

裝完之後，只是多了一個檔案 go.mod，放的是專案依賴的包的資訊，我們不會去手動更新其內容的，都是會通過工具（比如 go get）來維護它。

5. 跑一下 gin 的 hello world

接下來把 main.go 改下：

package main

import (
	"net/http"

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

func main() {
	r := gin.New()
	r.GET("/", func(c *gin.Context) {
		c.JSON(http.StatusOK, gin.H{
			"message": "Hello World!",
		})
	})
	r.Run()
}

注意：你其實只需要改 main 函數裡的內容就可以，import 裡的內容，編輯器在你儲存檔案後會自動幫你完成。

6. 執行 gin 專案

先來執行看下效果：

go run main.go

7. 存取

我用 postman 工具存取：

專案執行在 8080 埠上，存取後返回一個 json。

8. 分析程式碼

下一篇:前端程式設計師學習 Golang gin 框架實戰筆記之二分析 context

原文連結