Getting Started

快速开始

首页 · 工具链 · 版本与升级

先用 Triple 协议跑通本机 client → server，再接入注册中心。这样可以分别验证代码生成、服务实现和服务发现。下面采用主仓库维护的 CLI 模板路径；官网和 samples 中的其他版本示例也保留在后面的入口。

1. 准备工具

面向 v3.3.2，安装 Go 1.25.0 或满足该模块要求的更新版本，以及 protoc。如果使用 make proto-gen，还需要 Make；Windows 可在 WSL／Git Bash 等具备 Make 的环境操作，也可照生成的 Makefile 执行对应 protoc 命令。

go version
protoc --version
go install dubbo.apache.org/dubbo-go/v3/tools/dubbogo-cli@v1.0.1
go install dubbo.apache.org/dubbo-go/v3/tools/protoc-gen-go-triple@v3.3.2
go install google.golang.org/protobuf/cmd/protoc-gen-go@v1.36.6

protoc-gen-go 在此显式固定版本，避免示例随 @latest 漂移；它不使用 Dubbo-go 的版本号。确保 go env GOBIN（若已设置）或 go env GOPATH 下的 bin 在 PATH 中，然后检查这些可执行文件能被找到。工具各自的最低 Go 要求见其 go.mod，框架要求以目标 tag 为准。

来源：CLI 用法、Triple 生成器、工具发布记录、v3.3.2 go.mod。

2. 创建并生成代码

在一个新的空目录中执行：

mkdir hello-triple
cd hello-triple
dubbogo-cli newDemo .
make proto-gen
go get dubbo.apache.org/dubbo-go/v3@v3.3.2
go mod tidy

CLI 1.0.1 的模板说明记录了默认框架依赖 v3.3.1；上面的 go get 显式把新项目对齐到本页讨论的 v3.3.2。检查生成的 go.mod 和 Makefile，确认工具、框架和生成代码一致。CHANGELOG 中的工具说明

生成器会从 api/samples_api.proto 生成消息与 Triple 绑定。*.pb.go 包含 protobuf 消息，*.triple.go 包含客户端、handler 和注册辅助函数；不要手工修改生成文件。代码生成说明

3. 分别启动两端

第一个终端，在 hello-triple 目录执行：

go run ./go-server/cmd

第二个终端，在同一目录执行：

go run ./go-client/cmd

验收时确认服务端启动成功，客户端获得业务响应且没有连接或 RPC 错误；服务名、端口和方法以生成的模板为准。若失败，先按 问题排查 区分构建问题和网络问题。以上流程根据已收录的 CLI 文档和模板约定整理，本轮文档重建没有执行端到端服务启动。

4. 继续学习

• 官网 RPC 教程原文：讲解 IDL、服务实现、HTTP 调用与客户端；其中旧生成器地址需结合 工具链 阅读。
• 构建微服务：从直连过渡到服务发现。
• 配置与服务发现：YAML、Nacos、ZooKeeper 与 metadata。
• 官方 samples：覆盖跨语言、流式调用等场景；先检查示例提交对应的 go.mod，不假设 main 总是引用稳定版本。

如果使用 samples 的 helloworld，按它自己的 README 和实际目录运行。现有官网原文中出现的 server.go／client.go 与 samples 中 main.go 的差异，不应靠复制旧命令猜测解决。