Go-Zero微服务框架——学习笔记

📅 2026/8/12 18:57:01
Go-Zero微服务框架——学习笔记
1、快速安装运行视频地址https://www.bilibili.com/video/BV1vuVyzwEGN/?spm_id_from333.337.search-card.all.clickvd_source707ec8983cc32e6e065d5496a7f79ee6需要安装golandgoctlgo install github.com/zeromicro/go-zero/tools/goctllatestwindows下不用安装protobufmac和linux下需要安装建立一个api模版goctl api new 名称创建微服务项目后需要go mod tidy用这样一个bat可以为多个项目一次性tidyecho off setlocal enabledelayedexpansionechoBatch run go mod tidyrem script rootsetroot%~dp0remsourcebat pathsetsrc%root%proto-gen.batrem scan first-level subdirsfor/d %%din(%root%*)do(rem run tidyifgo.mod existsifexist%%~fd\go.mod(echo.echoProcessing: %%~fdpushd%%~fdgo mod tidypopd)else(echoNo go.mod, skip: %%~fd))echo.echoAlldonepause输入go run 名称.go 运行程序2、Air 热加载工具和Thunder Clienthttps://www.bilibili.com/video/BV1vuVyzwEGN?spm_id_from333.788.player.switchvd_source707ec8983cc32e6e065d5496a7f79ee6p2Airgo install github.com/air-verse/airlatest运行 air -v查看是否安装完成在某一个项目下运行air一旦代码修改air会自动更新不用重启goThunder Client这个插件和postman后apifox是差不多的我选择用国产的apifox不记录使用此插件3、API项目结构解析视频地址https://www.bilibili.com/video/BV1vuVyzwEGN?spm_id_from333.788.videopod.episodesvd_source707ec8983cc32e6e065d5496a7f79ee6p3hello/ ├── go.mod# Go 模块定义模块名 hello1依赖 go-zero v1.10.2├── go.sum# 依赖校验锁文件├── hello.api# API 定义文件DSLgoctl 生成代码的源├── hello.go# 程序主入口 main 函数├── etc/ │ └── hello-api.yaml# 运行时配置文件├── internal/# 内部包不对外暴露│ ├── config/ │ │ └── config.go# 配置结构体定义│ ├── handler/# HTTP 处理层Controller 层│ │ ├── hellohandler.go# 单个接口的处理器│ │ └── routes.go# 路由注册自动生成勿改│ ├── logic/ │ │ └── hellologic.go# 业务逻辑层Service 层│ ├── svc/ │ │ └── servicecontext.go# 服务上下文依赖容器│ └── types/ │ └── types.go# 请求/响应结构体定义自动生成勿改└── tmp/ └── main.exe# 编译产物4、RPC项目结构解析视频地址https://www.bilibili.com/video/BV1vuVyzwEGN?spm_id_from333.788.videopod.episodesvd_source707ec8983cc32e6e065d5496a7f79ee6p3mall/user/ ├── go.mod# Go 模块定义模块名 mall/user├── go.sum# 依赖校验锁文件├── user.go# 程序主入口 main 函数├── user.proto# protobuf 接口定义生成代码的源├── etc/ │ └── user.yaml# 运行时配置文件├── internal/# 内部包不对外暴露│ ├── config/ │ │ └── config.go# 配置结构体定义│ ├── server/ │ │ └── userserver.go# gRPC 服务端实现自动生成勿改│ ├── logic/ │ │ └── getuserlogic.go# 业务逻辑层│ └── svc/ │ └── servicecontext.go# 服务上下文依赖容器├── user/# protoc 生成的 gRPC 代码│ ├── user.pb.go# 消息结构体自动生成勿改│ └── user_grpc.pb.go# gRPC 服务端/客户端桩自动生成勿改├── userclient/ │ └── user.go# RPC 客户端封装给调用方用自动生成勿改└── data/ └── etcd/# etcd 数据目录运行时生成5. gRPC demo 代码生成https://www.bilibili.com/video/BV1vuVyzwEGN?spm_id_from333.788.videopod.episodesvd_source707ec8983cc32e6e065d5496a7f79ee6p4生成rpcgoctl rpc new 名称一般会建立一个目录比如mall然后生成多个rpc项目比如userorder等建立好项目后rpc代码就生成了如果需要再生成可以运行goctl rpc protoc “order.proto” --go_out. --go-grpc_out. --zrpc_out.可以做成一个bat文件进行生成echo off setlocal enabledelayedexpansion rem switch to batdirso it runs correctly from anywherecd/d%~dp0rem check goctl where goctlnul2nuliferrorlevel1(echo[error]goctl not found,installit first:echogoinstallgithub.com/zeromicro/go-zero/tools/goctllatest pauseexit/b1)rem loop .proto filesincurrentdir(no hardcoded name, worksforany module)setfound0for%%fin(*.proto)do(setfound1echo.echoGenerating: %%fgoctl rpc protoc%%f--go_out. --go-grpc_out.--zrpc_out.iferrorlevel1(echo[fail]%%f)else(echo[ok]%%f))rem no proto foundif!found!0(echo[hint]no .protoin%~dp0echoput this batinthe moduledirnext to .proto pauseexit/b1)rem tidy depsifgo.mod existsifexist go.mod(echo.echogo mod tidygo mod tidy)else(echo[hint]no go.mod here, skip tidy)echo.echoAlldonepause需要运行Etcd这是一个发布地址的组件win下自带模块其他系统需要安装如果没有启动可以运行这bat文件将其启动echo off :: 启动 etcd 服务注册中心 :: 数据目录放在 user 模块下避免散落在项目根目录setETCD_DIR%TEMP%\etcd\etcd-v3.5.21-windows-amd64\etcd.exesetDATA_DIR%~dp0data\etcdifnot exist%DATA_DIR%mkdir%DATA_DIR%echoStarting etcd...echoData dir: %DATA_DIR%%ETCD_DIR%--data-dir%DATA_DIR%也可以先在etc\user.yaml里先去掉Etcd使用apifox选择user.proto后就自动生成接口可以调用6.Go-Zero 的配置管理https://www.bilibili.com/video/BV1vuVyzwEGN?spm_id_from333.788.videopod.episodesvd_source707ec8983cc32e6e065d5496a7f79ee6p5配置文件etc\hello-api.yaml可以加入Log打印设置屏蔽info日志Name: hello-api Host:0.0.0.0 Port:8888# 日志级别设为 error屏蔽 info 级别的 HTTP 访问日志Log: Level: error加载配置文件的代码逻辑varconfigFileflag.String(f,etc/hello1-api.yaml,the config file)funcmain(){flag.Parse()varc config.Config conf.MustLoad(*configFile,c)...}把yaml的地址和config的结构体都交给conf.MustLoad进行建造