-
必须先调用r.ParseMultipartForm()（或r.ParseForm()）解析multipart/form-data，否则r.MultipartForm为nil，r.FormFile()将panic或返回空值；不可直接读r.Body。
-
在Beego模板中使用{{range}}时，当前作用域会切换为迭代项（如*models.Foo），导致.user等外层变量无法直接访问；需通过$.user显式引用根作用域下的数据。
-
Go字符串转数字首选strconv包，因fmt.Sscanf易panic、类型断言不安全；strconv.Atoi仅支持十进制int且精度/进制不灵活，应按需选用ParseInt/ParseUint/ParseFloat并正确处理错误、空格、科学计数法及性能问题。
-
OpenAI官方GoSDK已废弃，应使用第三方库github.com/sashabaranov/go-openai；需升级至v1.7.0+、校验APIKey、显式设置HTTP超时与重试，并严格遵循消息结构、模型名及参数格式。
-
不够用。硬编码读取环境变量会导致密钥泄露、无法区分环境、不支持热更新和权限隔离；应使用KubernetesSecret文件挂载（非环境变量），Go通过os.ReadFile安全读取，本地开发复用相同逻辑但切换路径，SOPS仅用于CI/CD解密生成Secret。
-
strconv.Atoipanic是因未检查错误，它仅支持纯数字字符串，空格、字母、符号或空串均返回error；正确用法必须显式处理err。
-
Go中strconv.Atoi等函数返回(int,error)两个值，无法直接用于结构体字面量初始化；需显式处理错误（如提前校验、封装panic版本或分步赋值），而非依赖语法糖忽略错误。
-
runtime.GOARCH直接返回编译时指定的目标CPU架构字符串，如"amd64"、"arm64"等，而非运行时系统实际架构；它由GOARCH环境变量或-build参数决定，与宿主机硬件无关。
-
默认gob编码在RPC中不够快，因其编码体积大、解析慢、不跨语言，高并发或大数据量下CPU和带宽消耗高；优化应换用protobuf+gRPC或在net/rpc上加压缩层。
-
正确构造测试请求需确保URL带协议和路径、body显式设为nil或io.Reader，并设置Content-Type；用httptest.NewRecorder捕获响应；完整链路测试应通过httptest.NewServer启动服务而非直调handler。
-
必须在读取request.Body前调用ParseMultipartForm，因其会惰性解析并缓存multipart数据；若Body已被消费（如io.ReadAll或FormValue触发默认解析），后续调用将失败或返回空。
-
Go类型断言失败会panic，因直接用value.(Type)时类型不匹配将触发不可恢复中断；必须使用value,ok:=interface{}.(Type)的comma-ok模式确保安全。
-
指针字段用于共享数据、节省内存和实现可变性。通过指向同一地址，多个结构体实例可共享底层数据，避免复制开销并实现同步更新；在大型对象或配置共享场景中提升性能；支持nil状态，适用于延迟初始化，如数据库连接池懒加载；合理使用可优化性能与状态管理。
-
sync/atomic是Go中用于无锁线程安全操作的基础工具，支持对int32、int64等基础类型的原子读写与CAS，需确保内存对齐、类型匹配，禁用结构体字段，推荐全局变量或指针声明，配合Load/Store/Add/Swap/CAS实现高效并发控制。
-
Go中map[string]struct{}的字段不可修改，因map值不可寻址，底层扩容可能导致内存位置变化，故禁止取地址以避免悬垂指针。
