-
<p>Go语言推荐使用单行注释，函数注释需以函数名开头、描述功能，包注释置于package前并用//包裹，导出变量常量应加注释说明用途，通过godoc生成文档，提升代码可读性与维护性。</p>
-
在Go中，os.Write返回的错误通常是*os.PathError类型，其Err字段封装了底层系统调用的errno（如syscall.ENOSPC），需通过类型断言提取并比对，而非直接断言为syscall.Errno。
-
sync.Map是Go为高并发读多写少场景设计的并发安全map，通过分片、原子操作和读写分离减少锁竞争，适用于缓存等场景，但不支持高效遍历或长度统计。
-
Go基准测试需写在_test.go文件中，函数名以Benchmark开头并接收testing.B参数；运行必须用gotest-bench=.（点匹配所有），否则不执行；建议加-benchmem看内存分配，并用b.ResetTimer()排除setup开销；b.N由框架自动调整，需在循环中使用；对比性能应使用benchstat分析多轮结果。
-
Go中map必须显式初始化（如make或字面量）才能赋值，nilmap写入会panic；原生map非线程安全，并发读写需sync.Map、sync.RWMutex或channel保护；key类型必须可比较，切片/map/函数等不可作key；make容量不能为负或过大。
-
Go构建约束是通过//go:build注释控制源文件编译的机制，支持平台、环境、特性等条件判断，需置于文件顶部且格式严格，配合-tags和-x可验证生效。
-
Go中捕获文件读写异常需显式检查error返回值，正确处理os.IsNotExist、os.IsPermission等错误，defer关闭文件并检查close错误，区分可恢复与不可恢复错误，避免panic，用fmt.Errorf包装错误增强上下文。
