ThinkPHP联表查询必须显式控制主表、别名、连接条件和字段来源；join()有字符串、二维数组、一维数组三种写法，行为不同且不可混用；table()只设主表，join()只追加连接；关联字段过滤或排序必须用join而非with；调试需输出真实SQL。
ThinkPHP 的联表查询不是“写完 join() 就能跑”，必须显式控制主表、别名、连接条件和字段来源，否则大概率查不到数据、字段冲突或 SQL 报错。
join() 参数格式错一个字符就报错
三种写法行为完全不同，混用直接失败：
- 字符串写法最常用但风险高：
->join('shop_class i ON a.shop_class = i.class_code')，适合单次 JOIN 或需指定RIGHT JOIN - 二维数组写法更安全：
->join(['shop_class i' => 'a.shop_class = i.class_code'])，支持连续调用、防 SQL 注入，推荐用于多表 LEFT JOIN - 一维数组只允许一次传多个字符串：
->join(['shop_class i ON a.shop_class = i.class_code', 'user u ON i.user_id = u.id'])，不能和字符串/二维混用
常见错误：->join(['shop_class i', 'a.shop_class = i.class_code']) 看似像二维，实为非法结构，框架会当字符串处理并抛出语法异常。
table() 和 join() 职责绝对不能互换
table() 只设主表（FROM 子句），join() 只追加连接（JOIN 子句）。错把逻辑塞进 where() 是高频翻车点：
立即学习“PHP免费学习笔记（深入）”；
- 错误写法：
->table('shop a, shop_class i')->where('a.shop_class = i.class_code')—— 这是隐式内连接，不走索引、无法控类型、字段易冲突 - 正确链路：
->table('shop a')->join('shop_class i ON a.shop_class = i.class_code')，后续所有field()、where()都必须带别名，如a.id、i.name - 若用
Db::name('shop')->alias('a')，则join()中的表名不能带库前缀，只写物理表名，如'shop_class i'，不是'think_shop_class i'
查关联字段要 where/order？只能用 join，with 不行
with() 返回嵌套对象，适合分页、展示；join() 返回一维数组，字段平铺，才能对关联字段做条件过滤或排序：
- 想查“分类名为 ‘数码’ 的所有商品”：
->join('category c ON g.cat_id = c.id')->where('c.name', '数码')—— 必须join -
with(['category' => function ($q) { $q->where('name', '数码'); }])无效：它只约束 category 表本身的查询，不会筛主表商品 - 想按分类名排序：
->order('c.name')同样依赖join后的别名字段，with生成的 SQL 不含ORDER BY c.name
调试一定要看真实 SQL，别猜
光看 PHP 链式调用看不出问题，必须验证最终语句：
- 在
select()前加：echo Db::getLastSql(); die;（TP6+） - 常见报错
Unknown column 'xxx' in 'on clause'：连接条件字段拼错，或别名没生效 - 报错
Not unique table/alias：某张表被重复引入，比如table()和join()同时写了shop
别名不统一、连接条件漏空格、ON 前少空格（如 'shop_class iON'）这些细节，都会让 SQL 生成失败，但错误提示往往不直接指向根源。
