一对多关系在Eloquent中由hasMany()和belongsTo()配对实现，关键看外键所在表：Post含user_id，则User模型用hasMany(Post::class)，Post模型用belongsTo(User::class)；外键非标准命名需显式传参。
怎么定义一对多关系（比如 User → Posts）
在 Eloquent 中，一对多关系由 hasMany() 和 belongsTo() 配对实现，关键不是「谁查谁」，而是「外键在哪边」。比如 Post 表有 user_id 字段，那关联就该定义在 User 模型里用 hasMany(Post::class)，而 Post 模型里用 belongsTo(User::class) 指向拥有者。
常见错误是反着写：在 Post 里写 hasMany(User::class)，结果查询报错或返回空集合——因为 Eloquent 默认按约定找 post_id 去关联 users 表，根本不存在这个字段。
-
User.php中定义：public function posts() { return $this->hasMany(Post::class, 'user_id', 'id'); }（第三个参数'id'可省略，因默认主键就是id） -
Post.php中定义：public function user() { return $this->belongsTo(User::class, 'user_id', 'id'); }（第二个参数'user_id'可省略，因默认外键名是model_name_id） - 如果外键不是标准命名（比如叫
author_id），必须显式传入，否则关联失效
为什么直接用 $user->posts 会 N+1 查询
当你循环用户并访问 $user->posts，Eloquent 默认懒加载（lazy loading），每遍历一个 User 实例，就额外执行一次 SELECT * FROM posts WHERE user_id = ?。100 个用户 = 100 次查询，数据库压力陡增。
这不是 bug，是设计行为——Eloquent 不会自动猜你「接下来要读关联数据」。必须主动预加载。
安装、修复、更新或打包一个基于 Python 和 PyMySQL 实现的 Windows `mysql` 命令。适用于用户希望在 PowerShell/CMD 中输入 `mysql` 时重定向到 Python 实现、需要交互式输入 MySQL 连接信息、需要同步到当前用户本地 bin 目录，或需要将该能力封装成可公开复用的 Codex skill。
- 正确做法：用
with()预加载，$users = User::with('posts')->get(); - 支持嵌套预加载，比如同时查
posts和每个post的comments：User::with(['posts.comments' => function ($query) { $query->where('approved', true); }])->get(); - 避免在循环里调用
load()，它仍是 N+1；load()仅适合已查出模型后「临时补查」
withCount() 和 withSum() 这类聚合方法怎么用
想查「每个用户的发帖数」或「总阅读量」，别再手写子查询或循环统计。Eloquent 提供了原生聚合预加载，底层走 LEFT JOIN + GROUP BY，一条 SQL 解决。
-
withCount('posts')会在结果中添加posts_count属性，值为整数$users = User::withCount('posts')->get(); // $users[0]->posts_count === 5 - 支持条件计数：
User::withCount(['posts as published_posts' => function ($query) { $query->where('status', 'published'); }])->get();此时属性名变成published_posts -
withSum('posts', 'views')直接计算字段和，结果属性为posts_sum_views；注意 MySQL 8.0+ 才支持SUM()在 JOIN 后正确分组，低版本可能需手动selectRaw
预加载时怎么加 where 条件却不影响主模型结果
比如「查所有用户，但只预加载他们近 7 天的帖子」。如果直接 with(['posts' => fn($q) => $q->whereDate('created_at', '>=', now()->subWeek())])，主查询仍返回全部用户，只是每个用户的 posts 集合被过滤了——这是预期行为。
但容易踩的坑是：用了 whereHas()，它会**过滤主模型**（比如只返回「至少有一篇近 7 天帖子」的用户），这和预加载目的不同。
- 纯预加载过滤：用
with()的闭包，安全User::with(['posts' => function ($query) { $query->where('status', 'active') ->orderByDesc('created_at') ->limit(5); }])->get(); - 若需主模型也被条件限制，才用
whereHas()：User::whereHas('posts', fn($q) => $q->where('status', 'active'))->get(); - 闭包里不能用
select()改字段（会丢关联必需字段），如需精简字段，用select(['id', 'title', 'user_id'])并确保包含外键和主键
关联的复杂点不在写法，而在「什么时候该用 with、什么时候该用 whereHas、什么时候该拆成两条查询」。多数性能问题，其实卡在没意识到 with() 闭包里的条件只作用于关联表，不影响主表结果集。
