如何开发自定义RuboCop Cop并通过zeitwerk:check检查？

核心问题定位 #

你遇到的NameError: uninitialized constant RuboCop::Cop::Style::Base是因为**RuboCop::Cop::Style::Base这个类根本不存在**，所有自定义Cop的正确父类是RuboCop::Cop::Base，同时Zeitwerk的自动加载机制和RuboCop的加载逻辑冲突，导致依赖加载顺序错误。

分步解决方案 #

• 修正Cop的继承关系
  确保你的自定义Cop代码直接继承RuboCop::Cop::Base，并正确引入依赖：

  # lib/rubocop/cop/style/simplify_not_empty_with_any.rb
  require 'rubocop/cop/base'
  
  module RuboCop
    module Cop
      module Style
        class SimplifyNotEmptyWithAny < Base
          MSG = 'Use `any?` instead of `!empty?`'.freeze
  
          def on_send(node)
            # 你的检测与修复逻辑
          end
        end
      end
    end
  end
  

• 让Zeitwerk忽略RuboCop自定义目录
  在Rails项目的config/initializers/zeitwerk.rb中添加配置，阻止Zeitwerk自动加载自定义Cop文件（交给RuboCop自身的加载机制处理）：

  Rails.autoloaders.main.ignore(Rails.root.join('lib/rubocop'))
  

• 配置RuboCop识别自定义Cop
  在项目根目录的.rubocop.yml中添加自定义Cop的加载路径：

  require:
    - ./lib/rubocop/cop/style/simplify_not_empty_with_any.rb
  

  如果有多个自定义Cop，可以直接加载整个目录：

  require:
    - ./lib/rubocop
  

• 验证修复效果
  先执行bundle exec rubocop -L确认自定义Cop已被加载，再运行rails zeitwerk:check，此时错误应该消失。

补充说明 #

Zeitwerk会自动扫描lib目录下的文件并按命名空间加载，但RuboCop的Cop有自己的加载流程，强行让Zeitwerk加载会导致自定义Cop先于RuboCop的Base类被加载，从而触发未初始化常量的错误。通过让Zeitwerk忽略该目录，就能避免这个冲突。

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