[图片] 环境说明 mac osx 10.12.6 golang 1.10.3 protobuf 3.5.1 步骤 从 github 上获取工程手动编译 进入到 $GOPATH/src/github.com/pseudomuto/protoc-gen-doc/cmd 目录, 执行 go build -o protoc- ..

protobuf 文档生成

本贴最后更新于 349 天前,其中的信息可能已经时异事殊

环境说明

步骤

进入到 $GOPATH/src/github.com/pseudomuto/protoc-gen-doc/cmd 目录, 执行 go build -o protoc-gen-doc -a 可以得到 protoc-gen-doc 的可以执行文件

protoc --plugin=protoc-gen-doc=./proto-gen-doc  --doc_opt=markdown,protocol.md  --doc_out=./doc  ./*.proto

proto 文件示例

/**
 * @desc 登录服务器回包 20001
 * @copyright :copyright:2018 nbob
 * @release Monday, September 24, 2018
 * @author BobWong
 */
syntax = "proto3";
package protobuf;

message LoginServerBackItem {
    string playerId = 1; // 角色id
    string name = 2; // 角色名称
    int64 lastLoginTime = 3; // 最后一次登录时间
}



message LoginServerBackRes {
    message Data {
        LoginServerBackItem player = 1; // 角色
    }
    int32 code = 1;
    Data data = 2;
}

/**
 * 被服务器踢出
 */
message KickByServer {
    int32 reason = 1; // 被踢出原因
}

生成的 markdown 文档示例

imagepng

1 回帖
请输入回帖内容...
  • MartinRS API

    棒棒😋