-
Go批量读写文件应使用os.ReadDir与io.Copy组合：用os.ReadDir安全遍历目录（替代filepath.Walk），控制并发数防fd耗尽，写入时合理使用bufio.Writer并务必flush，错误需区分临时与永久失败。
-
Go中处理API错误需统一分类、封装结构化响应并映射HTTP错误：定义APIError结构含code/status/message/details；用中间件统一处理panic和error；按4xx/5xx/业务错误语义化响应；集成validator聚合校验错误到details。
-
Go1.20+标准库原生不支持HTTP/3，必须使用quic-go+http3第三方库；服务端需用http3.Server和quic.Listener，客户端需用http3.RoundTripper或支持HTTP/3的curl。
-
实现用户认证系统，包含注册、登录、JWT鉴权及受保护路由。项目结构清晰，使用Gin框架与GORM操作SQLite数据库，通过bcrypt哈希密码，JWT实现中间件鉴权，适合学习扩展。
-
硬编码struct比map[string]interface{}快3–5倍，因避免动态分配与反射；优先用json.Decoder流式解析降低内存占用；延迟解析用json.RawMessage；性能瓶颈优先分析GC与分配，再考虑第三方库。
-
Go反射无法仅凭字符串类型名创建实例，必须先获取reflect.Type（如通过reflect.TypeOf或预注册映射），再用reflect.New或reflect.Zero创建零值，或调用导出的工厂函数实现动态实例化。
-
md5.Sum不能用于大文件秒传校验，因其返回固定数组且不支持增量计算；应使用md5.New()返回的hash.Hash接口配合io.TeeReader流式计算MD5。
-
Go工厂模式用接口+函数返回具体实例解耦创建与使用，应返回明确接口而非interface{}，通过注册表替代if/else，支持选项函数或配置结构体传参，注册需线程安全，工厂应轻量无副作用。
-
Go不能直接写跨平台UI组件，因其标准库无GUI支持，各平台窗口管理、事件循环、绘图接口差异巨大，硬桥接导致维护成本爆炸；需通过抽象层（Widget/Renderer/EventBroker）封装差异，并用纯函数指针或方法集定义bridge接口，避免反射和runtime.Caller引发CGO问题。
-
用http.ListenAndServe启动服务端口被占会静默失败，应显式构造http.Server实例捕获并打印底层错误；默认Handler为nil时使用http.DefaultServeMux，但推荐显式创建http.ServeMux提升可控性与可测试性。
-
Go语言通过time包提供时间处理功能，使用time.Now()获取当前时间，Format方法按“2006-01-0215:04:05”格式化输出，Parse解析时间字符串，支持时区、时间计算、比较及Sleep、Ticker等定时操作。
-
因为多个生产者并发写入时执行顺序不可预测，若任一生产者提前关闭通道，其余生产者将panic。
-
Go调试核心是确保dlv与IDE通信正常且项目满足调试前提：使用Go1.18+默认构建（禁用-s-w）、正确安装dlv、配置launch.json的mode和program字段，并验证二进制含DWARF调试信息。
-
Go工具链需协同配置GOPRIVATE、Git凭据和模块路径语义才能拉取私有模块：设GOPRIVATE跳过代理校验，配GitHTTPSToken或SSH密钥确保认证，模块路径须与Git地址一致或用replace映射。
-
Go包文档格式是工具链契约：包注释须顶格写在package前且无空行，首句以包名开头并带句号；导出标识符注释须紧贴声明上方无空行；仅支持//行注释，禁用空行、制表符及Markdown。
