Ruby中奇怪的类继承问题：RSpec测试无法找到父类Piece

用RSpec测试继承自Piece的Queen类时，报错找不到父类Piece，但同继承自Piece的Pawn、Rook等类的测试能正常运行，已确认导入路径配置无误。

错误信息 #

An error occurred while loading ./spec/queen_spec.rb.
Failure/Error:
NameError:
  uninitialized constant Piece
  class Queen < Piece
                ^^^^^
/spec/queen_spec.rb:1:in `<top (required)>
No examples found.

相关代码 #

spec/queen_spec.rb #

# spec/queen_spec.rb
require_relative 'spec_helper'

spec/spec_helper.rb #

# spec/spec_helper.rb

$LOAD_PATH.unshift(File.join(File.dirname(__FILE__), '..', 'lib'))
$LOAD_PATH.unshift(File.dirname(__FILE__))

require 'pieces/piece'
require 'pieces/pawn'
require 'pieces/rook'
require 'pieces/knight'
require 'pieces/queen'

排查与解决方向 #

• 验证Piece类文件的有效性：检查lib/pieces/piece.rb是否存在，文件内是否正确定义了class Piece（无拼写错误、未嵌套在未加载的模块中）。可通过命令ruby -r ./lib/pieces/piece.rb -e "puts Piece"测试能否正常加载Piece类。
• 检查文件加载顺序与依赖：虽然spec_helper中先加载了piece.rb，但如果queen.rb存在语法错误或加载时依赖其他未初始化的内容，会导致加载失败。可单独加载queen.rb测试：ruby -r ./lib/pieces/piece.rb -r ./lib/pieces/queen.rb -e "puts Queen"。
• 确认命名空间一致性：如果Piece类属于某个模块（如Chess），需确保Queen类继承时使用完整命名空间（class Queen < Chess::Piece），且spec_helper中已加载对应模块。
• 检查工作目录：运行RSpec时需确保在项目根目录执行，否则$LOAD_PATH中../lib的相对路径会失效。
• 清除缓存：尝试用rspec --no-cache运行测试，避免Ruby文件缓存导致的加载异常。

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