hz 的基本使用

hz 的基本使用。

基本使用

new: 创建一个 Hertz 新项目

  1. 创建新项目

    # 在 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"},说明接口调通。

注意事项

  1. hz new 只用于初始化项目,更新项目则使用 hz update, 具体使用方法可参考 使用 protobuf使用 thrift

  2. hz 判断一个项目是否存在是看生成的 .hz 文件的。若 .hz 文件存在使用 hz new 会报错,不存在使用 hz update 会报错


最后修改 June 26, 2024 : doc: add construct use case (#1098) (83b7cf9)