-
TCP是字节流协议，不存在天然的“消息边界”；Go的net.Conn.Read()会阻塞直到有数据可读或连接关闭，无法“非阻塞地读取完整消息”，正确做法是基于协议定义（如长度前缀或分隔符）逐步解析流数据。
-
runtime.Caller比反射更靠谱，因反射不提供函数名获取能力，而Caller通过栈回溯返回含包路径的函数全名，且比底层FuncForPC更安全易用。
-
GoHTTP中间件应在请求入口统一生成traceID并注入context，通过私有key避免冲突；日志需由支持context的handler自动提取traceID，而非手动添加或依赖全局变量。
-
ClickHouse连接失败主因是协议与端口不匹配：默认clickhouse-go走HTTP（8123），但生产环境常仅开放TCP（9000）；应改用tcp://DSN、确认服务端tcp_port启用，或显式设secure=false；空结果多因未检查rows.Err()及字段顺序/类型不匹配；批量插入须用PrepareBatch而非单条执行；GROUPBY需显式AS别名并按序Scan；务必核对驱动与服务端版本兼容性。
-
选择安装方法需权衡版本需求与便捷性，Ubuntu等系统可用apt安装或官网二进制包；若版本过低，可添加PPA、使用snap或手动安装；GOROOT为安装路径，GOPATH为工作区，Module启用后项目可脱离GOPATH，通过gomodinit初始化，依赖自动管理，配置PATH包含$GOPATH/bin和$GOROOT/bin即可正常使用。
-
Go测试函数必须命名为Test且参数为testing.T，需置于*_test.go文件中、同包内，子测试名禁用斜杠和空格，测试文件应保持纯净以避免意外依赖。
-
DFS拓扑排序结果逆序是因递归退出时记录节点，此时所有后继已处理完，天然满足前置依赖优先；需reverse得正序，或改用BFS法避免栈溢出。
-
ArgoCD的Application资源需显式定义在Git仓库中（如apps/my-service.yaml），由AppProject授权部署，spec.source.repoURL必须是集群可访问地址，spec.destination.namespace不可省略，默认default常导致同步失败。
-
zk.Connect不panic的关键是：传全地址列表、设5秒以上超时、连接后立即用State()检查是否为StateConnected，不能仅依赖err==nil。
-
生产环境应选用官方go-elasticsearch/v7客户端，需显式调用Do()、按字节而非条数切分bulk、解析聚合时先取键再断言类型。
-
swaginit需显式指定多目录路径并严格遵循注释格式：-g指定入口文件，-d列出internal/handler等子包；注释字段名、缩进、空格须精确匹配；泛型需手动@Schema声明；Nginx部署注意alias末尾斜杠。
-
Go函数参数永远传值，slice/map/chan因底层含指针字段而表现类似引用；array纯值类型，修改不影响原值；用指针参数需满足修改需求、大对象避免拷贝或接口要求指针接收者。
-
trace.Start()必须显式调用且配对trace.Stop()，否则trace.out为空或仅有头尾事件；常见原因包括未传*os.File、Stop未执行、程序过快退出、Start放置过晚。
-
Sync.Map不能用反射遍历，因其内部字段未导出且未实现迭代接口；必须通过Range()等公开API访问，注意nil检查、类型转换安全及性能陷阱。
-
Go语言中处理异常和错误的方式主要依赖于error返回和panic/recover机制。1.error返回用于常规错误处理，函数通过返回error值让调用者处理或忽略错误，适用于可预见的问题，如文件打开失败、网络请求超时等；2.panic用于触发运行时异常，程序沿着调用栈回溯，直到崩溃，适合处理不可预料的错误，如数组越界、空指针访问；3.recover只能在defer函数中使用，用来捕获panic，防止程序崩溃，常用于中间件统一拦截异常、测试代码模拟异常行为以及初始化阶段的关键错误处理；4.使用error
