-
Go包文档该写在哪儿才被godoc和VSCode正确识别Go不认README.md作为包文档——哪怕你写得再漂亮，godoc、godoc（或新版godoc命令）和大多数IDE都不会把它当包说明。真正起效的只有源码文件顶部的注释块。必须是紧贴package声明上方的「顶级注释块」，且中间不能空行注释必须是//开头的普通注释，不是/**/块注释（后者会被忽略）如果包有多个.go文件，只有一份注释生效：按字典序第一个含包注释的文件胜出别在main包里写长文档
-
Go编译默认不嵌入DWARF调试信息，需加-gcflags="all=-N-l"并避免-ldflags="-s-w"；core文件需ulimit-cunlimited且未被core_pattern重定向；gdb无法直接识别goroutine，需结合infothreads与bt逐线程分析。
-
Cmd.StdoutPipe()不能直接连shell管道，因os/exec.Cmd不解析shell语法，需用exec.Command("/bin/sh","-c","cmd1|cmd2")显式调用shell解释器，并注意Start后读取、分别处理stdout/stderr、读完pipe防阻塞。
-
import用于导入外部包以使用其导出项，需掌握路径规则（标准库、第三方、本地）、别名避免冲突、下划线触发初始化、三段式分组管理。
-
正确使用Go反射需减少调用频率、缓存类型信息、避免热路径使用。通过初始化阶段缓存字段元数据到map，后续直接查表；优先用指针赋值并统一处理指针层级；已知类型范围时用类型断言替代反射；合理设计架构可使运行时性能接近原生。
-
Go项目包结构核心原则是按功能职责而非技术分层组织，用internal严格隔离非导出API，模块根目录即主go.mod位置；按业务域（如order/、payment/）而非MVC分层；命令、配置、第三方适配器需分离以保持核心逻辑纯净。
-
zip.Writer默认用zip.Store无压缩存储，需显式设FileHeader.Method=zip.Deflate启用DEFLATE压缩；空/小文件可能回退Store；已压缩格式再压无效；解压前须确保ZIP完整，Close()不可遗漏。
-
Go协程同步优化重在轻量精准：优先用chanstruct{}做零拷贝信号通知；高频读写用sync.Once和sync.Map替代手写锁；禁用sleep/空select轮询，改用通道、Cond或ctx取消。
-
Go服务金丝雀发布需外部路由（如Nginx/Envoy）分流，服务自身暴露版本头、保障API兼容、安全透传灰度上下文（需显式配置header透传）、封装统一灰度判断函数、用Context跨goroutine传递，并通过分模式健康检查（如/healthz?mode=canary）精准控制流量。
-
Go语言支持跨平台交叉编译，通过设置GOOS和GOARCH环境变量指定目标操作系统和CPU架构，如GOOS=linuxGOARCH=amd64生成Linux64位程序，结合CGO_ENABLED=0可生成静态二进制文件用于容器部署，配合shell脚本可批量构建多平台可执行文件，实现“一次编写，到处运行”。
-
goroutine泄漏比开销更危险，真正危害在于未回收的goroutine，如channel未关闭、select阻塞、HTTPhandler中goroutine生命周期失控；应通过pprof、NumGoroutine打点排查，优先复用对象、使用errgroup和context控制并发。
-
低覆盖率主因是未覆盖错误返回、边界输入、并发分支和私有逻辑；需构造失败场景、完善表驱动测试、显式验证并发与初始化副作用，并在CI中设置覆盖率门禁。
-
sync.Once.Do不会重复执行，因其用uint32原子变量+CompareAndSwapUint32实现无锁等待，仅首个goroutine执行函数，其余等待完成；若函数panic，状态仍置为已完成，错误被静默吞掉。
-
应使用sync.Once（或Go1.21+的sync.OnceValue）实现单例，因其保证初始化仅一次、并发安全、语义清晰；直接用全局变量破坏封装且不安全，手动sync.Mutex易出竞态，且单例对象自身也需线程安全。
-
Go语言需手写解释器模式实现Expression解析，因go/parser仅支持Go语法；须定义Expression接口及节点类型，用递归下降解析器处理优先级和括号，并解决类型混合、短路求值与作用域问题。
