如何使用gin框架搭建一个简单的web服务

Gin 框架的简单介绍

Gin是一个Go(Golang)编写的轻量级http web框架,
运行速度非常快,如果你是性能和高效的追求者,我们推荐你使用Gin框架。

Gin最擅长的就是Api接口的高并发,
如果项目的规模不大,业务相对简单,这个时候我们也推荐您使用 GinI

当某个接口的性能遭到较大挑战的时候,这个还是可以考虑使用Gin重写接口。
Gin也是一个流行的golangWeb 框架,Github Strat 量已经超过了50k。

官网地址: https://gin-gonic.com/zh-cn/

gin 环境搭建

1,首先要安装 go
可以在cmd 窗口,通过 go env 来查看是否安装了go

2,根据官网的内容进行操作
找一个目录,在这个目录下执行下面这2个命令

mkdir gin-quickstart && cd gin-quickstart
go mod init gin-quickstart

执行:go mod init gin-quickstart 后,会出现:
go: creating new go.mod: module gin-quickstart
表示创建成功了

mkdir gin-quickstart 创建一个名为 gin-quickstart 的目录
cd gin-quickstart 进入刚刚创建的 gin-quickstart 目录
&& 表示:只有前一条命令执行成功,才会执行后一条命令
mkdir gin-quickstart && cd gin-quickstart : 新建一个名为 gin-quickstart 的文件夹,并立即进入这个文件夹

go mod init gin-quickstart 表示如下:
在当前目录初始化一个 Go 模块,模块名为 gin-quickstart,并生成 go.mod 文件
go mod:Go 的模块管理命令。
init:初始化一个新的 Go 模块。
gin-quickstart:模块路径/模块名。
执行后,当前目录下会生成一个 go.mod 文件

并且在控制台会出现这个:go: creating new go.mod: module gin-quickstart
简单说:这行提示表示 Go 项目初始化成功,模块名为 gin-quickstart,并生成了 go.mod 文件。

image

3,添加 Gin 作为依赖:

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

如果出现:go: module github.com/gin-gonic/gin: Get "https://proxy.golang.org/github.com/gin-gonic/gin/@v/list": dial tcp 142.250.199.81:443: connectex: A connection attempt failed because the connected party did not properly respond after a period of time, or established connection failed because connected host has failed to respond.
这是国内访问 Go 官方代理proxy.golang.org 被墙导致的。换成国内镜像代理即可解决
解决办法:执行:

go env -w GOPROXY= https://goproxy.cn ,direct

image
image

在gin-quickstart下创建main.go文件

package main

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

func main() {
	// 创建一个默认的路由引擎
	r := gin.Default()
	// 定义路由
	r.GET("/", func(c *gin.Context) {
		c.JSON(200, gin.H{
			"message": "Hello, World! I am a Gin server! ",
		})
	})
	//  启动服务,端口为8080,当然你也可以更改的哈
	r.Run(":8080")
}

启动这个项目,在浏览器输入:http://localhost:8080/
image
自此:gin框架搭建一个简单的web服务

正确的项目结构应该是

gin-quickstart
├── go.mod
├── go.sum
└── main.go
image

启动服务报错

gin-quickstart\main.go:4:2: no required module provides package github.com/gin-gonic/gin: go.mod file not found in current directory or any parent directory; see 'go help modules'
image
是因为你的执行目录错误了。
image
这样的打开目录来执行就好了

posted @ 2026-10-17 17:13  何人陪我共长生  阅读(12)  评论(0)    收藏  举报