goctl1.3.0新命令goctl rpc protoc問題
一、官網相關描述文獻地址:
準備工作? https://go-zero.dev/cn/prepare.html
protoc & protoc-gen-go安裝? ? https://go-zero.dev/cn/protoc-install.html
rpc命令? ? ? https://go-zero.dev/cn/goctl-rpc.html?
【說明】：有需要查看相關內容請搜索? 推薦使用? 和goctl rpc protoc greet.proto --go_out=. --go-grpc_out=. --zrpc_out=.
微服務? ? ? https://go-zero.dev/cn/micro-service.html
【說明】：有需要查看相關內容請搜索? ? 舊版本的 protoc-gen-go 不支持 --go-grpc_out
官方倉庫針對protoc說明 https://github.com/zeromicro/go-zero/issues/1226
其他
二、相同版本環境:
需要安裝如下版本軟件:
go環境版本(推薦1.16+), 驗證安裝結果 如下
go version
//結果:
go version go1.15.1 darwin/amd64
//我的電腦結果:
go version go1.17.5 windows/amd64
安裝過程看官網
go mod開啟go env GO111MODULE
goenvGO111MODULE
//結果:
on
goctl版本1.3.0
goctl -v
goctl version 1.3.0-20220201 windows/amd64
protoc版本3.19.4(找不到官網小版本)
下載頁面
https://github.com/protocolbuffers/protobuf/releases
window當前版本下載地址:
https://github.com/protocolbuffers/protobuf/releases/download/v3.19.4/protoc-3.19.4-win64.zip
其他
第一種方式:goctl rpc proto命令生成rpc代碼(這種方式未來確定會廢棄)
需要安裝如下版本軟件:
1.protoc-gen-go(使用v1.3.2), 驗證安裝結果 如下
//1.16+版本使用go install
goinstallgithub.com/golang/protobuf/protoc-gen-go@v1.3.2
goget-ugithub.com/golang/protobuf/protoc-gen-go@v1.3.2
驗證結果:
user.proto文件內容如下:
syntax="proto3";
packageuser;
// protoc-gen-go 版本大于1.4.0, proto文件需要加上go_package,否則無法生成
optiongo_package="./userClient";
messageIdRequest{
stringid=1;
}
messageUserResponse{
// 用戶id
stringid=1;
// 用戶名稱
stringname=2;
// 用戶性別
stringgender=3;
}
serviceUser{
rpcgetUser(IdRequest)returns(UserResponse);
}
user.proto目錄文件夾執行如下命令:
goctl rpc proto-srcuser.proto-dir./protoDemo1
//結果
D:\Tools\Go\Code\src\go-zero-demo\mall\user\rpc>goctl rpc proto-srcuser.proto-dir./protoDemo1
deprecated: use"goctl rpc protoc"instead,forthe details see"goctl rpc protoc --help"
protoc--proto_path=D:\Tools\Go\Code\src\go-zero-demo\mall\user\rpc user.proto--go_out=plugins=grpc:D:\Tools\Go\Code\src\go-zero-demo\mall\user\rpc\protoDemo1--go_opt=Muser.proto=.././userClient
Done.
所有的代碼會在./protoDemo1目錄下面生成
其他
第二種方式:goctl rpc protoc命令生成rpc代碼(未來版本會使用這種方式)
需要安裝如下版本軟件:
protoc-gen-go(使用v1.26版本), 驗證安裝結果 如下
//1.16+版本使用go install
goinstallgoogle.golang.org/protobuf/cmd/protoc-gen-go@v1.26
goget-ugoogle.golang.org/protobuf/cmd/protoc-gen-go@v1.26
protoc-gen-go-grpc(使用v1.1版本)
【說明】當前官方文檔并沒有介紹這種方式安裝，默認第一種方案安裝
//1.16+版本使用go install
goinstallgoogle.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.1
goget-ugoogle.golang.org/grpc/cmd/protoc-gen-go-grpc@v1.1
【錯誤提醒】如果沒有安裝protoc-gen-go-grpc，你輸入
goctlrpcprotocuser.proto--go_out=./protoDemo2--go-grpc_out=./protoDemo2--zrpc_out=./protoDemo2
會出現如下報錯:
D:\Tools\Go\Code\src\go-zero-demo\mall\user\rpc>goctlrpcprotocuser.proto--go_out=./protoDemo2--go-grpc_out=./protoDemo2--zrpc_out=./protoDemo2
protocuser.proto--go_out=./protoDemo2--go-grpc_out=./protoDemo2
?[31mgoctl:generationerror:'protoc-gen-go-grpc'????????????????????????е????
?????????????
--go-grpc_out:protoc-gen-go-grpc:Pluginfailedwithstatuscode1.
goctlversion:1.3.0-20220201windows/amd64
?[0m
驗證結果:
user.proto文件內容同第一種方式一樣:
user.proto目錄文件夾執行如下命令:
goctl rpc protoc user.proto--go_out=./protoDemo2--go-grpc_out=./protoDemo2--zrpc_out=./protoDemo2
所有的代碼會在./protoDemo2目錄下面生成
其他
goctl rpc protoc --help命令講解:
--go_out參數和--go-grpc_out必須保持一致，這是protoc-gen-go-grpc的命令;
--zrpc_out參數就是第一種方式的src參數
D:\Tools\Go\Code\src\go-zero-demo\mall\user\rpc>goctlrpcprotoc--help
NAME:
goctlrpcprotoc-generategrpccode
USAGE:
example:goctlrpcprotocxx.proto--go_out=./pb--go-grpc=./pb--zrpc_out=.
DESCRIPTION:
fordetails,seehttps://go-zero.dev/cn/goctl-rpc.html
OPTIONS:
--zrpc_outvaluethezrpcoutputdirectory
--stylevaluethefilenamingformat,see[https://github.com/zeromicro/go-zero/tree/master/tools/goctl/config/readme.md]
--homevaluethegoctlhomepathofthetemplate
--remotevaluetheremotegitrepoofthetemplate,--homeand--remotecannotbesetatthesametime,iftheyare,--remotehashigherpriority
Thegitrepodirectorymustbeconsistentwiththehttps://github.com/zeromicro/go-zero-template directory structure
