局部视图本地变量无需显式传递即可传入ViewComponent的原理

你看到的这种“隐式传递”其实是Ruby的关键字参数简写语法，和Rails的局部视图作用域、ViewComponent本身没有直接关系，是Ruby语言层面的语法糖。

具体规则 #

当你调用方法（包括初始化ViewComponent实例的new方法）时，如果关键字参数的名称和当前作用域中已存在的变量名完全一致，就可以只写参数名加冒号（param:），省略掉右边重复的变量名（param: param）。

对应你的场景 #

在局部视图中，你已经通过locals传入了name和environment两个本地变量，它们处于当前视图的作用域内。当你写：

SportsTeam::Performance::Component.new(name:, environment:)

Ruby会自动将其解析为：

SportsTeam::Performance::Component.new(name: name, environment: environment)

两者的执行效果完全一致。

扩展验证 #

这种写法并非Rails专属，在任意Ruby代码中都能使用。比如：

def print_info(name:, environment:)
  puts "#{name} in #{environment}"
end

name = "Rockets"
environment = :production

# 简写写法
print_info(name:, environment:)
# 等价于
print_info(name: name, environment: environment)

局部视图的作用域只是让name和environment这两个变量能被当前视图代码访问到，但真正实现“简写传递”的是Ruby的关键字参数语法，而非Rails或ViewComponent的特殊机制。

内容的提问来源于stack exchange，提问作者J.R. Bob Dobbs