-
Go的json.Unmarshal不panic，所有错误均通过error返回；必须检查err!=nil，测试需覆盖非法JSON、字段标签对齐、json.RawMessage延迟解析及错误输入拦截。
-
Go并发超时控制核心是安全等待或及时放弃任务：首选context.WithTimeout精确管控生命周期；次选select+time.After轻量等待；批量任务用errgroup+context统一协调；务必调用cancel、记录日志、避免泄漏并测试验证。
-
环境变量未生效因加载时机过早，应移至main()后或用os.LookupEnv；YAML解析失败多因缩进、字段未导出或缺少yamltag；多环境配置需在ReadInConfig前设绝对路径；热更新须WatchConfig在ReadInConfig后调用并用channel通知变更。
-
包名冲突时必须用点号前缀重命名Go不允许两个同名包直接导入，哪怕路径不同也会报import"xxx"isaprogram,notanimportablepackage或更常见的multiplepackagesnamedxxx。这时候不能删包、不能改源码，唯一解法是显式重命名——而且必须加点号（.）或自定义别名，否则编译器不认。常见场景：你同时用github.com/golang/freetype和golang.org/x/image/font，两者都导出了Font
-
传统的日志收集方式效率低下主要因为1.采用阻塞式I/O导致串行处理多个日志源时产生延迟；2.轮询机制浪费CPU资源并引入延迟；3.无法有效应对高并发和实时性要求。这些问题使得系统在面对大量日志数据时难以保持高效与稳定。
-
log.SetOutput不能直接接*os.File实现轮转，因标准文件不支持自动切换，需自定义io.Writer封装轮转逻辑，含大小监控、原子替换、并发锁及过期检测。
-
本文详解如何在Go中通过手动管理smtp.Client实现单连接复用，避免每次发信都重建连接，显著提升高并发邮件发送场景下的性能与资源利用率。
-
Go中http.Handler链是事实上的装饰器模式，需返回新Handler、透传context、统一错误处理、严格控制中间件顺序，并通过路由器注册而非单个handler绑定。
-
Neo4jGo驱动不内置图算法，需调用服务端GDS插件执行；参数须用map传入、结果中nodeId需用gds.util.asNode()转换，且须正确配置GDS内存与超时。
-
image.Decode总是返回"unknownformat"是因为标准库默认仅注册PNG解码器，JPEG、GIF等需手动导入如_"image/jpeg"以触发init()注册；解码依赖magicbytes匹配已注册格式，未导入则失败。
-
不应该。Go程序中原始错误信息含路径、函数名等敏感细节，直接暴露给用户既不安全也不友好；应区分开发者可观测错误与用户可理解提示，通过自定义错误类型和人工撰写的中文消息映射业务语义，HTTP响应返回结构化code/message/request_id，CLI输出友好提示，日志保留完整错误链，且对外暴露时切断错误链避免泄露。
-
sqlc生成的Go代码编译报错“undefined:sqlc”是因为sqlc是纯代码生成工具，不提供运行时包，需正确配置package名、存放路径及依赖管理。
-
基本for循环包含初始化、条件和迭代，如fori:=0;i<5;i++{}，用于常规循环操作。
-
关键在于流式控制读写节奏：用bufio.Reader（64KB缓冲）封装文件、手动处理UTF-8BOM、设FieldsPerRecord=-1应对字段数不固定；读取用Read()循环逐行处理，禁用ReadAll()；写入用bufio.Writer（1MB缓冲）并每万行Flush()，禁用WriteAll()。
-
交叉编译必须同时指定GOOS和GOARCH且关闭CGO_ENABLED=0，否则易链接失败或生成不可部署二进制；仅设其一将默认当前平台，导致伪交叉编译；纯Go程序需禁用cgo，含import"C"的代码（含依赖）会强制启用cgo并引发冲突。
