Golang Gin系列-2：搭建Gin 框架环境

开始网络开发之旅通常是从选择合适的工具开始的。在这个全面的指南中，我们将引导你完成安装Go编程语言和Gin框架的过程，Gin框架是Go的轻量级和灵活的web框架。从设置Go工作空间到将Gin整合到项目中，本指南是高效而强大的web开发路线图。

安装Go语言

在我们深入安装过程之前，根据开发需求选择正确的Go版本至关重要。访问Go官方网站（https://golang.org/dl/）下载最新的稳定版本。下面几个环境变量需要正确设置

GOROOT

• 含义：它指定了 Go 语言的安装目录。这个目录包含了 Go 编译器、标准库等核心组件。例如，在 Go 1.18 版本的安装目录下，你可以找到 src（包含 Go 语言标准库的源代码）、pkg（编译后的包文件存放位置）和 bin（Go 工具链的可执行文件，如 go、gofmt 等）等子目录。

• 作用：当你执行 Go 相关的命令时，系统会根据 GOROOT 来找到 Go 的核心组件。例如，go build 命令构建程序时，会从 GOROOT 下的标准库中引用必要的库文件。

• 设置示例（以 Linux 为例）：如果 Go 安装在 /usr/local/go，你可以通过以下方式设置 GOROOT：

export GOROOT=/usr/local/go

GOPATH

• 含义：GOPATH 是 Go 工作区的路径，它是一个或多个目录的路径列表。在早期的 Go 版本中，这是一个非常重要的环境变量。GOPATH 下包含三个主要的子目录：src、pkg 和 bin。src 用于存放 Go 源代码，pkg 用于存放编译后的包文件，bin 用于存放可执行文件。

• 作用：它为 Go 项目提供了统一的工作空间。例如，当你使用 go get 命令下载外部依赖包时，这些包会被放置到 GOPATH/src 目录下；当你构建自己的 Go 项目时，项目的源代码也可以存放在 GOPATH/src 下。

• 设置示例（以 Windows 为例）：假设你想将GOPATH 设置为 C:\Go\workspace，你可以通过以下步骤设置：

  1. 打开系统的环境变量设置窗口。
  2. 在 “用户变量” 或 “系统变量” 中添加一个名为 GOPATH 的变量，其值为 C:\Go\workspace。

GOBIN

• 含义：GOBIN 用于指定 Go 二进制文件（可执行文件）的安装目录。
• 作用：当你使用 go install 命令安装 Go 程序时，生成的可执行文件会被放置到 GOBIN 指定的目录中。这有助于组织和管理 Go 生成的可执行文件。
• 设置示例（以 Linux 为例）：如果想将 Go 二进制文件安装到 ~/go/bin，可以设置 GOBIN 如下：

export GOBIN=~/go/bin

• 创建Go项目

使用‘ go mod ’命令为项目初始化新的go模块。这有助于管理依赖关系并促进与其他开发人员的协作。

建议开发环境为：WSL+VSCode，具体环境搭建过程再次略过。

安装Gin Framework

• Gin框架概述

Gin是一个面向Go的高性能web框架，提供路由、中间件支持等功能。让我们探讨一下为什么Gin是Go web开发的热门选择。通过下面命令安装Gin， 将Gin导入到Go项目中来确认安装。

$ go install github.com/gin-gonic/gin@latest

下面创建一个简单的Gin应用程序，让我们使用Gin构建一个基本的web应用程序来理解它的核心概念。然后设置路由器，定义路由和处理程序来处理传入的HTTP请求。

package main

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

func main() {
    router := gin.Default()

    router.GET("/", func(c *gin.Context) {
        c.JSON(200, gin.H{
            "message": "Hello, Gin!",
        })
    })

    router.Run(":8080")
}

执行Gin应用程序并在web浏览器中访问它。下面我们在Gin中添加中间件，通过集成中间件来增强Gin应用程序的功能，如日志记录、身份验证等。

package main

import (
    "github.com/gin-gonic/gin"
    "net/http"
)

func Logger() gin.HandlerFunc {
	return func(c *gin.Context) {
		fmt.Println("before call...")
		c.Next()
		fmt.Println("after call...")
	}
}

func main() {
    router := gin.Default()

    // Use the Logger middleware
    router.Use(Logger())

    router.GET("/", func(c *gin.Context) {
        c.JSON(http.StatusOK, gin.H{
            "message": "Hello, Gin with Middleware!",
        })
    })

    router.Run(":8080")
}

再次运行出现，可以看到控制台打印的日志信息，可以判断日志中间件已经启用。

结论

恭喜! 你已经成功安装了Go和Gin框架，设置了Go工作区，并构建了基本的Gin web应用程序。