Ruby on Rails方法参数后加冒号与普通参数的区别

两段代码的本质区别是：带冒号的email:是必需关键字参数，不带冒号的email是普通位置参数，二者在语法规则、调用逻辑上的差异如下：

语法规则差异 #

• 普通位置参数（第二段代码写法）：参数和传入值的绑定完全依赖传参的位置顺序，和参数名本身没有绑定关系。定义时要求调用方必须传入对应数量的位置参数，少传、多传都会直接抛出ArgumentError。
• 带冒号的必需关键字参数（第一段代码写法）：参数和传入值的绑定依赖显式指定的参数名，和传参顺序无关。这种写法要求调用方必须以参数名: 值的键值对形式传参，漏传指定参数、传入未定义的关键字参数都会抛错。

调用逻辑差异 #

普通位置参数的调用规则 #

第二段代码定义的方法，只能按位置顺序传参：

def initialize(email)
 @email = email
end

# 合法调用：第一个传入位置的值自动绑定给email形参
User.new("test@example.com") # @email 正常拿到"test@example.com"

如果尝试用键值对形式传参，方法会把整个hash当成一个普通位置值接收：

User.new(email: "test@example.com") 
# 此时@email拿到的是{email: "test@example.com"}这个hash对象，不是预期的邮箱字符串

如果参数列表有多个位置参数，传参时顺序写反不会触发语法报错，只会导致业务逻辑错误，排查成本很高。

关键字参数的调用规则 #

第一段代码定义的方法，必须显式指定参数名传参，传参顺序不影响绑定结果：

def initialize(email:)
  @email = email
end

# 合法调用
User.new(email: "test@example.com") # @email正常拿到目标值

# 多参数时换顺序也不影响
# 比如定义def initialize(email:, name:)
# 调用时写User.new(name: "张三", email: "test@example.com")完全正常

如果尝试按位置传值，会直接触发报错：

User.new("test@example.com") 
# 抛出ArgumentError: missing keyword: :email

这种写法在多参数场景下不需要记忆参数顺序，靠参数名匹配能大幅降低传参错误的概率，也是Ruby on Rails框架新版本推荐的参数写法。

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