Db::query()用于查询，返回二维数组；Db::execute()用于增删改，返回影响行数；二者不可混用，否则导致逻辑错误或静默失败，且在读写分离下分别固定走读库和写库。
Db::query() 和 Db::execute() 必须严格按语义区分使用，混用会导致逻辑错误或静默失败。
查数据必须用 Db::query()，返回数组；改数据必须用 Db::execute()，返回整数
常见错误是拿 Db::execute() 去执行 SELECT，结果得到一个数字（比如 0 或 1），后续 foreach 直接报错；反过来用 Db::query() 执行 UPDATE，看似没报错，其实 SQL 根本没走写逻辑，数据完全没变。
-
SELECT、SHOW、EXPLAIN、WITH查询 → 只能用Db::query() -
INSERT、UPDATE、DELETE、REPLACE、TRUNCATE→ 只能用Db::execute() - 读写分离环境下，
Db::query()固定走读库，Db::execute()固定走写库，和 SQL 内容无关
参数绑定只支持值，表名/字段名/排序方向必须白名单校验后拼接
ThinkPHP 的占位符（:status 或 ?）只解析为 PDO 参数绑定，不支持动态字段或表名。写成 "ORDER BY :field" 不会生效，而是把 :field 当成字符串字面量处理，甚至直接报错。
- 正确写法：
Db::query("SELECT * FROM user WHERE status = :status", ['status' => 1]) - 错误写法：
Db::query("SELECT * FROM :table WHERE id = ?", [$tableName, $id])——:table不会被替换，PDO 会报语法错误 - 动态
ORDER BY字段：先判断$sortField是否在['id', 'name', 'create_time']白名单中，再拼进 SQL："ORDER BY {$sortField} DESC" - 表前缀可用
__USER__或__PREFIX__user，框架自动替换，但依然不能用于变量拼接场景
事务中执行原生 SQL 要特别注意回滚边界和语句兼容性
原生 SQL 在事务里不自动受控——Db::startTrans() 后执行的 Db::execute() 如果没抛异常，框架就认为“成功”，不会中断事务；更危险的是某些语句本身就不支持事务（如 CREATE TEMPORARY TABLE、SET @var=1），rollback() 完全无效。
立即学习“PHP免费学习笔记（深入）”；
- 所有原生操作必须包裹在
Db::startTrans()和Db::commit()/Db::rollback()之间 - 每个
Db::query()或Db::execute()都要检查返回值，或用try-catch捕获think\db\exception\DataNotFoundException和底层 PDO 异常 - 禁止在事务块中执行
DROP TABLE、ALTER TABLE、CREATE INDEX等 DDL 语句 - 调试时可调用
Db::getLastSql()查看最后生成的真实 SQL，但它只记录最近一次查询/执行，不是实时日志
别忽略返回值类型和错误处理方式差异
Db::query() 成功时返回二维数组（空结果也是 []），失败返回 false；Db::execute() 成功时返回影响行数（int），失败也返回 false。很多人直接 if ($res) 判断，但 Db::execute() 返回 0（比如 UPDATE 没匹配到记录）也会被当成失败。
- 安全判断写法：
if (false === $res)或if ($res !== false) - 查列表后别直接
foreach($res as $item)，先确认is_array($res) - 增删改后想确认是否真有数据变动，不能只看是否为
false，还要结合返回值是否 > 0 - 命名占位符（
:param）比问号占位符（?）更清晰，且 ThinkPHP 6 明确不兼容纯位置绑定（[1, 'abc']）
最易被忽略的是：动态字段拼接没有做白名单校验、事务中混入非事务语句、以及把 Db::execute() 的返回值当布尔值用——这三类问题在线上几乎无法复现，但一旦触发就是静默数据异常。
