当前位置：首页 > article >正文

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

article 2025/1/18 10:29:49

开始网络开发之旅通常是从选择合适的工具开始的。在这个全面的指南中，我们将引导你完成安装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")
}