Ruby 3.1.2代码遇Rubocop Lint/Syntax语法错误求助

环境信息 #

• Ruby版本：3.1.2
• Rubocop版本：1.34.1（基于Parser 3.1.2.1、rubocop-ast 1.21.0，运行环境：ruby 3.1.2 x86_64-linux）

原始代码 #

require "./person.rb"

class Teacher < Person

  def initialize(name: "Unknow", age, specialization)
    super(name, age)
    @specialization = specialization
  end

  def can_use_services?
    true
  end
end

Rubocop违规提示 #

classes/teacher.rb:3:1: E: Lint/Syntax: class definition in method body
(Using Ruby 3.2 parser; configure using TargetRubyVersion parameter, under AllCops)
class Teacher < Person
^^^^^
classes/teacher.rb:5:34: E: Lint/Syntax: unexpected token tIDENTIFIER
(Using Ruby 3.2 parser; configure using TargetRubyVersion parameter, under AllCops)
  def initialize(name: "Unknow", age, specialization)
                                 ^^^
classes/teacher.rb:5:53: E: Lint/Syntax: unexpected token tRPAREN
(Using Ruby 3.2 parser; configure using TargetRubyVersion parameter, under AllCops)
  def initialize(name: "Unknow", age, specialization)
                                                    ^
classes/teacher.rb:13:1: E: Lint/Syntax: unexpected token kEND
(Using Ruby 3.2 parser; configure using TargetRubyVersion parameter, under AllCops)
end
^^^

问题分析与解决方案 #

1. 解析器版本不匹配问题 #

Rubocop默认启用了Ruby 3.2的解析器，但你的运行环境是Ruby 3.1.2，版本不匹配导致语法检测出现错误判断。需要在Rubocop配置文件（.rubocop.yml）中指定目标Ruby版本：

AllCops:
  TargetRubyVersion: 3.1

2. 方法参数语法错误 #

Ruby 3.0及以后版本中，关键字参数和位置参数不能混合定义（位置参数必须放在关键字参数之前，或使用*明确分隔两类参数）。你的initialize方法中，name:是关键字参数，后面直接跟位置参数age和specialization，不符合Ruby 3.1的语法规则。

提供两种修正方案：

方案一：调整参数顺序，位置参数前置

def initialize(age, specialization, name: "Unknow")
  super(name, age)
  @specialization = specialization
end

方案二：用*分隔位置参数与关键字参数（保留原参数顺序）

def initialize(*, name: "Unknow", age, specialization)
  super(name, age)
  @specialization = specialization
end

修正后的完整代码 #

require "./person.rb"

class Teacher < Person
  def initialize(age, specialization, name: "Unknow")
    super(name, age)
    @specialization = specialization
  end

  def can_use_services?
    true
  end
end

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