binary.Read读不出数据主因是字节序错、字段未导出、TCP粘包未拆分；需用大写字段、定长类型、显式字节序、长度前缀分包并校验。
binary.Read 读不出数据？不是 Cursor 的锅，是协议对齐没做对。90% 的失败发生在字节序错、字段未导出、TCP 粘包未拆分这三处——Cursor 只生成代码骨架，它不替你抓包、不校验结构体大小、也不管你传的是 binary.BigEndian 还是 binary.LittleEndian。
为什么生成的 struct 用 binary.Read 总是零值或 panic
Cursor 生成的 Go struct 很可能字段名全小写（比如 id int32），而 binary.Read 要求所有参与编解码的字段必须首字母大写（即导出）。它不会报错，只会静默跳过小写字段，导致后续字段全部偏移。
- 检查生成的 struct：把
id int32改成ID int32，name string必须删掉——binary.Read遇到string会直接panic: invalid type - 禁用
int/uint：Cursor 若生成了len int，得手动改成Len uint32，否则在 64 位机器上占 8 字节，和协议里定义的 4 字节长度字段错位 - 别信任何
json:或binary:tag：Cursor 可能加了json:"len"，但binary.Read完全无视，字段顺序必须和协议文档一字不差
粘包没处理，binary.Read 就是瞎读
Cursor 不生成分包逻辑。它给你一个 Header struct，但不会帮你从 net.Conn 里先读 4 字节包长、再读完整包体——这是应用层必须补的环节。
- 协议头前 4 字节是
uint32总包长？先用binary.Read(conn, order, &pkgLen)提取，注意这个&pkgLen也得是uint32类型且导出 - 立刻校验：
if pkgLen == 0 || pkgLen > 1<code>MB</code> { conn.Close(); return }，防恶意构造超长包 - 分配缓冲区：
data := make([]byte, pkgLen)，然后严格用io.ReadFull(conn, data)——不是io.Read，后者可能只读一半就返回 - 最后才把
bytes.NewReader(data)交给binary.Read解析生成的 struct
变长字段（如用户名）怎么让 Cursor 生成可用代码
Cursor 默认不会为字符串生成长度前缀逻辑。它可能输出 Name string，但这在 binary.Read 下必 panic。你得手动改协议描述，让它生成可落地的字段定义。
Golang Uber Dig
下载
使用 uber-go/dig 在 Golang 中实现依赖注入——基于反射容器，提供 Provide/Invoke、dig.In/dig.Out 参数与结果对象，支持命名依赖等
- 把“用户名”定义成两段：先一个
NameLen uint16字段，再一个Name [64]byte数组（固定长度） - 解析时：
binary.Read(r, order, &msg.NameLen)→ 校验msg.NameLen <= 64→binary.Read(r, order, &msg.Name)→ 最后用bytes.TrimRight(msg.Name[:], "\x00")转string() - 如果真要 UTF-8 动态长度，协议里必须显式带长度字段，Cursor 生成的 struct 只能包含该长度字段 + 一个预分配切片（如
NameBuf []byte），但binary.Read仍不能直接读它——你得手写io.ReadFull(r, msg.NameBuf[:msg.NameLen])
unsafe 强转字节切片？别碰
有些 Cursor 模板或老教程会建议用 (*Header)(unsafe.Pointer(&data[0])) 一行搞定解析。这在实际项目里极危险：
立即学习“go语言免费学习笔记（深入）”；
- Go 编译器可能插入填充字节（padding），尤其当字段混用
uint8和uint32时，unsafe.Sizeof(Header)和协议实际字节数很可能不等 - 字段顺序稍有调整、GOARCH 切换（arm64 vs amd64）、甚至 Go 版本升级都可能导致内存布局变化
-
binary.Read虽啰嗦，但每一步可控、可打日志、可插校验——比如读完Length后立刻判断是否超出缓冲区剩余长度，避免越界
00 00 01 00 还是 00 01 00 00？结构体 unsafe.Sizeof 是不是和协议文档写的总字节数一致？有没有漏掉保留字段或校验和？这些没法靠工具自动生成，只能人盯。 
