hz 的基本使用

基本使用

new: 创建一个 Hertz 新项目

1. 创建新项目

   • 在 GOPATH 外执行
   • 在 GOPATH 下执行

   # 在 GOPATH 外执行，需要指定 go mod 名
   hz new -module hertz/demo
   
   # 整理 & 拉取依赖
   go mod tidy
   

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

   执行后会在当前目录下生成 Hertz 项目的脚手架。

2. 编译项目

   go build
   

3. 运行项目并测试

   运行项目：

   ./{{your binary}}
   

   测试：

   curl 127.0.0.1:8888/ping
   

   如果返回{"message":"pong"}，说明接口调通。

注意事项

在使用 hz new 创建了项目之后, 便可以使用 IDL 文件编写项目接口, 并使用 hz update 系列的命令来更新项目代码. 具体使用方法可参考使用 protobuf 和 使用 thrift。