golang hertz框架入门

news2025/10/31 16:24:52

两种模式新建项目
1、手动新建项目
2、使用hz工具新建项目

一、手动创建项目，并拉取框架

1、新建项目目录 hertz_demo_w
2、在项目跟目录新建main.go 文件

package main

import (
	"context"
	"github.com/cloudwego/hertz/pkg/app"
	"github.com/cloudwego/hertz/pkg/app/server"
	"github.com/cloudwego/hertz/pkg/common/utils"
	"github.com/cloudwego/hertz/pkg/protocol/consts"
)

func main() {
	h := server.Default()

	h.GET("/ping", func(ctx context.Context, c *app.RequestContext) {
		c.JSON(consts.StatusOK, utils.H{"message": "pong"})
	})

	h.Spin()
}

3、拉取框架

# 生成 go.mod 文件。
go mod init
# 整理 & 拉取依赖。
go mod tidy
#运行示例代码。
go run main.go

在这里插入图片描述

访问页面

在这里插入图片描述

目录结构

在这里插入图片描述

使用hz工具创建项目

安装 hz工具

# 安装
go install github.com/cloudwego/hertz/cmd/hz@latest
# 查看安装版本
hz -v

在这里插入图片描述

创建项目

#进入项目目录
 cd hertz_demo_w
 # GOPATH 下执行，go mod 名字默认为当前路径相对 GOPATH 的路径，也可自己指定
hz new
# 整理 & 拉取依赖
go mod init # 上一步在 GOPATH 下执行不会生成 go.mod
go mod tidy

在这里插入图片描述

修改文件，并访问

1、修改 biz\handler\ping.go

// Code generated by hertz generator.

package handler

import (
	"context"

	"github.com/cloudwego/hertz/pkg/app"
	"github.com/cloudwego/hertz/pkg/common/utils"
	"github.com/cloudwego/hertz/pkg/protocol/consts"
)

// Ping .
func Ping(ctx context.Context, c *app.RequestContext) {
	c.JSON(consts.StatusOK, utils.H{
		"message": "hello golang hertz",
	})
}