-
sync.Cond 出现等待不返回时，先检查共享条件是否由同一把锁保护，再确认 Wait 是否位于 for 循环中。本文用原创 Go 示例拆开 Signal、Broadcast、条件状态与 channel 的适用边界，帮助定位所谓的唤醒丢失。
-
context.WithValue 出现字段覆盖时，通常不是值被修改，而是相同键在父子 Context 中发生遮蔽。本文用包内私有键类型和类型安全访问器规避跨包冲突。
-
Go 的 ctx.Err() 只能告诉你已取消或已超时，context.Cause(ctx) 才能携带主动取消的具体原因。本文用原创示例拆开主动取消、超时取消和父子上下文竞争时的判断方式。
-
Go 的 context.AfterFunc 回调是在上下文取消后异步启动的，stop 返回 true 才表示回调被阻止；返回 false 不等于回调已经完成。本文按取消、停止和完成三个时刻拆解排查方法，并给出可等待回调收尾的写法。
-
Go net/http 中，响应 Trailer 不是普通响应头，服务端要在写出响应前声明尾部字段，客户端还要先把 Response.Body 读到 EOF 才能读取最终 Trailer。本文解释声明顺序、读取时机与为空排查方法。
-
Go net/http 中，ReadHeaderTimeout 只限制请求头，读取请求体要用 ReadTimeout 或按请求设置 ResponseController.SetReadDeadline。本文给出慢上传、超大请求、客户端断开和 HTTP/1.1 连接关闭的处理方式。
-
Go net/http 的请求体是一次性读取资源。Client.Do 会关闭请求体，关闭 TCP 连接也不会把 Body 重置；需要重试或重定向时，应保存原始数据、重新创建 Request，或确保 GetBody 能返回新的读取器。
-
unsafe.Slice 的 len 参数决定返回切片的长度和容量，计算时若混用元素数与字节数，或发生整数溢出，就可能把访问范围带出原始对象。本文按指针来源、Sizeof 换算、nil 特例和边界测试逐步定位并修正。
-
Go 包迁移时，type A = B 只增加一个兼容名称，不会创建新类型，因此 reflect.Type 的 Name 和 PkgPath 仍然对应原定义类型。本文用一个小项目区分类型别名与类型定义，并给出以 reflect.Type 身份比较替代字符串判断的兼容方案。
-
go build -trimpath 会移除可执行文件中的本机文件系统路径，但不会自动删除调试符号。本文用最小示例拆解它对堆栈、源码导航、CI 可复现构建和生产发布的影响，并给出按场景选择构建参数的方法。
-
接口断言成功只说明当前动态类型满足目标类型，不能证明 type switch 已覆盖全部输入。本文用 Go 示例定位遗漏 case，并补上 default 兜底和表格测试。
-
go list 看到的模块 Go 版本不等于当前真正执行编译的工具链版本。本文拆解 go.mod 的 go 与 toolchain、GOTOOLCHAIN 自动选择、工作区和 CI 环境差异，并给出一套可复制的排查命令。
-
go generate 默认在包含指令的 Go 包源目录运行。本文从工作目录、相对路径、环境变量和模块根目录入手，排查命令找不到、输入为空与生成文件落错位置等问题。
-
调整 GOGC 或 runtime/debug.SetGCPercent 后，延迟不会按固定方向变化。本文用固定工作负载、隔离的基准样本和延迟分位数，对照分析 GC 频率、堆空间、吞吐与 p95/p99 的关系。
-
Go 容器内存限制不是把 SetMemoryLimit 当成硬上限，而是先给 cgroup 预留运行时和外部内存，再用 GOMEMLIMIT 或 SetMemoryLimit 约束 Go runtime 的软目标。本文按预算、配置、观测和回退步骤给出可复用做法。
