Rails 7模型关联局部视图的默认规则及相关文档查询

1. 约定的具体行为 #

当你在视图中调用 <%= render @products %> 时，Rails会触发以下自动逻辑：

• 识别集合中单个对象的模型类型（此处为Product），将模型名转为小写并添加下划线前缀，得到局部视图文件名：_product.html.erb
• 遍历@products集合中的每个对象，将单个对象以模型名小写的变量名（此处为product）传入对应的局部视图
• 自动拼接所有局部视图的渲染结果，最终输出到页面中

2. 官方文档出处 #

你之前查看的指南章节未覆盖这个细节，该约定的详细说明在Rails官方指南的**「Rendering Collections」**章节中，核心规则包括：

• 渲染集合时，Rails默认查找与集合元素模型同名（下划线格式）的局部视图
• 自动为局部视图传递与模型名小写一致的局部变量，无需手动指定locals参数

3. 底层原理说明 #

这个机制不需要模型实现render_in方法，因为集合渲染的逻辑完全在Action View的渲染层完成：

• render方法会先判断传入的参数是否为集合类型（如Active Record Relation、数组）
• 如果是集合，会调用内部的render_collection方法，自动完成视图查找、变量赋值和循环渲染流程
• 整个过程是Rails「约定优于配置」理念的典型体现，减少了手动循环和局部视图调用的冗余代码

示例验证 #

假设你有一个Order模型的集合@orders，调用<%= render @orders %>时：

• Rails会自动查找_order.html.erb局部视图
• 每个局部视图中可以直接使用order变量访问单个订单对象

内容的提问来源于stack exchange，提问作者Zack