Rails 5无法引入lib目录加载的模块问题求助

嘿，我刚好碰到过类似的问题，Rails 5的自动加载规则在处理lib目录时确实有不少需要注意的细节，咱们一步步来搞定它：

1. 先确认自动加载的命名约定（最关键！） #

Rails 5默认使用的经典自动加载器，对文件名和模块名的对应关系要求很严格：

• 顶级模块Surveyable对应的文件应该直接放在lib/目录下，也就是lib/surveyable.rb
• 如果你要把文件放在lib/surveyable/子目录里，那模块必须是嵌套结构，比如module Surveyable::SurveyableCore，对应的文件是lib/surveyable/surveyable_core.rb

你的当前结构是lib/surveyable/surveyable.rb里定义了顶级module Surveyable，这就和自动加载规则不匹配了，Rails自然找不到对应的模块。

2. 调整方案二选一： #

方案A：修改文件路径（推荐） #

把lib/surveyable/surveyable.rb移动到lib/surveyable.rb，模块代码保持不变：

# lib/surveyable.rb
require 'active_support/concern'
module Surveyable
  extend ActiveSupport::Concern
  class_methods do
    def sjs_elements(&block)
      # 你的业务代码
    end
  end
end

然后在User模型里直接引入：

# app/models/user.rb
class User < ApplicationRecord
  include Surveyable
end

方案B：保留子目录，调整模块嵌套 #

如果一定要保留lib/surveyable/子目录，修改模块为嵌套结构：

# lib/surveyable/core.rb
require 'active_support/concern'
module Surveyable
  module Core
    extend ActiveSupport::Concern
    class_methods do
      def sjs_elements(&block)
        # 你的业务代码
      end
    end
  end
end

然后在User模型里引入嵌套模块：

# app/models/user.rb
class User < ApplicationRecord
  include Surveyable::Core
end

3. 别忘了重启开发服务器！ #

修改application.rb里的autoload_paths配置后，必须重启Rails开发服务器，新的加载路径才会生效，这一步很多人容易忽略。

4. 备选方案：手动require（不推荐，但应急可用） #

如果暂时不想调整结构，可以在User模型里手动加载模块：

# app/models/user.rb
require Rails.root.join('lib', 'surveyable', 'surveyable')
class User < ApplicationRecord
  include Surveyable
end

不过这种方式会绕过Rails的自动加载机制，长期来看还是遵循命名约定更稳妥。

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