-
原子操作仅适用于单字段无竞争场景，多字段协同、高竞争或需内存序保证时应优先用mutex；结构体字段不可直接原子更新，须拆分或用atomic.Value；忽略内存序在非x86架构易出错。
-
nats.Connect连不上JetStream是因服务端未启用，需加-js参数或配置jetstream块；js.Publish失败、消息丢失、重复消费等问题均源于JetStream未正确配置和使用。
-
使用gorilla/websocket在Golang中实现文件传输需遵循以下步骤：1.建立WebSocket连接，通过Upgrader结构体将HTTP升级为WebSocket；2.发送端分块读取文件并通过conn.WriteMessage发送；3.接收端持续监听并拼接数据至文件完成；4.可扩展发送元信息以支持多文件及进度显示；5.注意缓冲区大小、并发控制和错误处理。整个过程依赖于WebSocket的字节流特性，确保数据可靠传输。
-
Worker启动时必须接收context.Context参数，否则上层无法取消；传context.Background()或内部新建独立ctx均导致ctx.Done()永不触发、select无法响应取消。
-
Protobuf的Go实现不支持反射直接序列化struct，必须使用protoc-gen-go生成的类型；Avro的Go库（如hamba/avro）支持运行时schema+reflect，适用于动态适配场景。
-
Gin本身无内置优雅关闭，需用http.Server.Shutdown()配合signal监听和context超时，手动管理所有goroutine退出；漏掉任一环节（如ticker、DB、Redis或子goroutine未响应ctx.Done）将导致进程卡住。
-
sync.Map适用于小流量、单机、QPS几百的幂等场景，但无自动过期、不跨进程；需用结构体缓存结果、定时清理、避免key污染，Redis需原子SetNX+EX，DB唯一索引为兜底。
-
Example函数必须以Example开头且无参数：命名须为funcExampleXXX()，放于_test.go中同包，用fmt.Println打印输出，运行用gotest-run^Example，文档通过godoc或pkg.go.dev查看。
-
Gio是即时模式2D渲染库，非传统GUI框架；黑屏主因是漏掉op.InvalidateOp{}.Add(ops)或未调用gtx.Layout()；输入需手动注册pointer.InputOp/key.InputOp并拉取事件；widget.Clickable适合简单点击，复杂交互须用底层pointer.InputOp。
-
goroutine中panic无法被外层defer捕获，必须在每个goroutine内部用deferrecover()处理；errgroup.Group可安全统一管理多goroutine错误；channel发送错误需避免关闭后发送或死锁。
-
Go并发下载需限制goroutine数量并配置http.Client：设MaxIdleConns/PerHost、用channel控并发、每任务独立context.WithTimeout、写文件须隔离路径或加锁，优先用io.Copy确保健壮性。
-
要用go/ast提取单行注释，需启用parser.ParseComments模式获取ast.File.Comments，遍历ast.CommentGroup.List中的*ast.Comment，用fileset.Position(c.Pos()).Line获取行号，并用strings.TrimPrefix清理"//"前缀。
-
在Golang中，若要在性能敏感场景中高效复制文件，应优先选择syscall.Sendfile。1.io.Copy通用性强但性能较低，因其涉及多次内存拷贝和上下文切换；2.Sendfile利用零拷贝技术，在内核态直接传输数据，显著提升大文件传输效率；3.io.Copy在某些情况下会自动使用sendfile，但如包装了缓冲层则无法触发该优化；4.若需跨平台兼容或处理小文件，io.Copy更为适用，而在Linux环境下构建高性能服务时推荐使用syscall.Sendfile。
-
Go缓存并发优化需依读写比例选方案：读多写少用sync.RWMutex+双检锁；高频写+稀疏key用sync.Map；容忍stale用atomic.Value+不可变结构；并控制粒度、TTL与淘汰策略。
-
Go单例模式通过包级变量和同步机制实现，常见方式包括：1.懒汉模式（非线程安全）；2.加锁的懒汉模式；3.sync.Once推荐方式；4.饿汉模式；5.atomic无锁实现。sync.Once最常用，兼顾安全与性能。
