非阻塞通道封装须禁用裸chan暴露：私有chan字段、构造函数确保make初始化、提供trysend/tryrecv方法、内部select+default实现非阻塞逻辑。

非阻塞通道封装必须绕开 chan 零值误用

直接暴露裸 chan 类型的模块极易出错：未初始化的 chan 是 nil，一发送就 panic；关闭后继续发送也 panic；接收方无法判断是否该退出。封装的第一步不是加功能，而是堵住这些运行时漏洞。

• 所有对外暴露的通道字段必须是私有（小写），通过构造函数返回结构体实例，内部确保 make(chan ...) 已执行
• 禁止导出 chan 类型字段，改用方法控制读写入口，例如 TrySend(v T) bool 和 TryRecv() (T, bool)
• 避免在模块内使用 for range 消费通道——它隐式依赖 close()，而关闭时机常不可控；改用显式 select + default 或 ctx.Done() 退出

select + default 必须作为封装核心逻辑

非阻塞不是“加个 default 就完事”，而是要把这个模式固化进方法实现里，否则调用方仍可能写出阻塞代码。比如 TrySend 方法内部必须用 select 包裹，不能只在外层调用时临时加。

• TrySend 内部必须是：

  select {
  case c.ch 

• TryRecv 同理：

  select {
  case v := 

• 切忌把 select 逻辑甩给使用者——这等于没封装，反而增加误用风险

缓冲区大小不能硬编码，得按场景可配

一个“高性能”封装如果把缓冲大小写死成 1024，在视频流分发场景下可能刚够，在日志采集场景下又太小。缓冲区本质是内存与延迟的权衡点，必须外露配置项。

Golang Naming

Go（Golang）命名规范 — 包括包、构造函数、结构体、接口、常量、枚举、错误、布尔值、接收器、getter/setter、函数等。

下载

• 构造函数接受 bufferSize int 参数，拒绝
• 对视频流等大块数据场景，建议默认值设为 4096；对高频小消息（如心跳），设为 64 更安全
• 提供 Len() 和 Cap() 方法供调用方监控积压，但不要暴露底层 chan，避免绕过封装逻辑

超时与上下文支持不能靠文档提醒，得强制集成

纯 select + default 解决的是“此刻忙不忙”，但很多业务需要“最多等 100ms”。如果封装不内置 context.Context 支持，调用方只能自己套一层 select，破坏封装一致性。

• 提供 SendCtx(v T, ctx context.Context) error 方法，内部用 select + ctx.Done() 实现带超时的发送
• 错误返回必须区分：超时返回 context.DeadlineExceeded，通道满返回自定义错误（如 ErrChannelFull），便于上游做不同降级
• 不提供 RecvCtx 的简易版——接收端若超时退出，容易丢数据；应引导用户用 TryRecv + 外层重试，或明确要求传入带取消信号的 ctx

真正难的不是写几个 select，是让所有路径都走同一套非阻塞契约：发送不卡、接收不挂、满时不崩、关时不 panic。一旦某个方法漏掉 default 或绕过缓冲检查，整个模块的“高性能”就塌了一角。

golang免费学习笔记（深入）：立即使用
在学习笔记中，你将探索golang的核心概念和高级技巧！