Go 官方 protobuf 库（github.com/golang/protobuf）提供了 proto.MarshalTextString 函数，可将 Protocol Buffer 消息序列化为结构清晰、缩进规范、便于调试的文本格式，功能等效于 C++ 中的 DebugString()。
go 官方 protobuf 库（github.com/golang/protobuf）提供了 `proto.marshaltextstring` 函数，可将 protocol buffer 消息序列化为结构清晰、缩进规范、便于调试的文本格式，功能等效于 c++ 中的 `debugstring()`。
在 Go 中调试或日志记录 Protocol Buffer 消息时，直接打印二进制字节或结构体默认字符串（如 fmt.Printf("%+v", msg)）往往难以理解字段语义与嵌套关系。为此，github.com/golang/protobuf/proto 包提供了专用于人类可读输出的序列化函数：proto.MarshalTextString。
该函数将 proto.Message 接口类型的实例转换为符合 Protocol Buffer 文本格式规范（即 .proto 文件定义的文本语法）的字符串，支持嵌套消息、重复字段、枚举名称（而非数值）、空字段省略（默认行为）等特性，输出结果高度可读且与官方工具（如 protoc --decode_raw）兼容。
以下是一个典型使用示例：
package main
import (
"fmt"
"github.com/golang/protobuf/proto"
// 假设已生成 example.pb.go，对应 example.proto
"your/project/example"
)
func main() {
p := &example.Test{
Label: proto.String("this"),
Reps: []int64{4, 3, 2, 1},
InnerTest: &example.Test_InnerTest{
InnerLabel: proto.String("is the end"),
},
}
text := proto.MarshalTextString(p)
fmt.Println(text)
}
输出效果类似：
label: "this"
reps: 4
reps: 3
reps: 2
reps: 1
inner_test {
inner_label: "is the end"
}
⚠️ 注意事项：
- proto.MarshalTextString 不包含任何换行或缩进以外的格式化控制（如字段排序、注释、默认值显式输出），其行为严格遵循 protobuf 文本格式规范；
- 若需更灵活的格式（如 JSON 风格缩进、含默认值、忽略零值等），应考虑迁移到新版 google.golang.org/protobuf（即 protoreflect 生态），并使用 proto.MarshalOptions{EmitUnpopulated: true}.MarshalTextString(msg) 或结合 jsonpb（已弃用）/protojson（推荐）包；
- 旧版 github.com/golang/protobuf 已归档，新项目建议使用 google.golang.org/protobuf，其 prototext.MarshalString 是 proto.MarshalTextString 的现代替代，API 更稳定、性能更优、扩展性更强。
总结：对于快速调试与日志输出，proto.MarshalTextString 是 Go 中最轻量、最直接的人类可读 protobuf 序列化方案；长期维护项目请优先采用 google.golang.org/protobuf/encoding/prototext 包中的 MarshalString 函数，并配合模块化编码选项实现精细化控制。
