17 lines
809 B
Markdown
17 lines
809 B
Markdown
|
# AI 指南 - @go/db
|
||
|
|
|
||
|
|
## 🤖 AI 调用规则
|
||
|
|
- **版本**: v1.0.1
|
||
|
|
- **核心原则**: 优先使用结构化绑定（`To`, `MapResults`），避免手动拼装 SQL 结果。
|
||
|
|
- **敏感数据**: 必须通过 `SetEncryptKeys` 配置密钥，确保 DSN 中的密码安全。
|
||
|
|
- **读写分离**: 鼓励在 DSN 中配置多个 Host 以利用内置的读写分离机制。
|
||
|
|
- **性能优化**:
|
||
|
|
- 大规模查询应优先绑定到 Struct 切片。
|
||
|
|
- 频繁执行的 SQL 应使用 `Prepare`。
|
||
|
|
- **事务处理**: 始终使用 `tx.Finish(err == nil)` 或 `defer tx.CheckFinished()` 确保事务闭环。
|
||
|
|
|
||
|
|
## ⚠️ 注意事项
|
||
|
|
- 严禁在代码中硬编码数据库凭据。
|
||
|
|
- 严禁忽略 `Exec` 或 `Query` 返回的 `Error`。
|
||
|
|
- SQLite 模式下，时间字段会自动转换，无需手动解析字符串。
|