В чём разница между require и require_relative в Ruby?

require

require 'name' ищет файл name.rb (или нативное расширение name.so/name.bundle) в директориях массива $LOAD_PATH. Ruby обходит их слева направо и загружает первый найденный файл. Загруженные пути записываются в $LOADED_FEATURES — повторный require того же пути возвращает false и не выполняет файл снова.

$LOAD_PATH.unshift('./lib')
require 'my_gem'   # ищет lib/my_gem.rb

require_relative

require_relative 'path' строит абсолютный путь относительно файла, содержащего вызов (__FILE__). $LOAD_PATH при этом не используется. Это удобно для внутренних зависимостей внутри проекта.

# lib/app/models/user.rb
require_relative 'address'       # lib/app/models/address.rb
require_relative '../services/auth'  # lib/app/services/auth.rb

Ключевые отличия

• Поиск: require — через $LOAD_PATH; require_relative — относительно __FILE__.
• Переносимость: require_relative всегда найдёт файл независимо от того, откуда запущен скрипт; require может не найти, если директория не добавлена в $LOAD_PATH.
• Гемы: публичный API гема пишет require 'gemname'; внутренние файлы используют require_relative.
• eval / irb: require_relative в eval/irb бросает LoadError, потому что __FILE__ там равно (eval) — нет файловой базы.

Пример структуры гема

# lib/mylib.rb  — точка входа (публичный require 'mylib')
require_relative 'mylib/version'
require_relative 'mylib/client'
require_relative 'mylib/errors'

module Mylib
  # ...
end

autoload как альтернатива

Ruby также предоставляет autoload :ClassName, 'path' — файл загружается лениво при первом обращении к константе. Удобно для ускорения старта, но создаёт потенциальные проблемы с потокобезопасностью в Ruby < 2.0.

module Mylib
  autoload :Client,  'mylib/client'
  autoload :VERSION, 'mylib/version'
end

Подводные камни

• Если запустить скрипт через ruby script.rb из другой директории, require './lib/foo' сломается, а require_relative 'lib/foo' — нет.
• $LOADED_FEATURES хранит абсолютные пути, поэтому один и тот же файл можно загрузить дважды, если require и require_relative разрешились в разные пути (например, через симлинк).
• Порядок в $LOAD_PATH важен: Bundler prepend'ит пути гемов в начало, что может перекрыть системные версии.
• В Ruby 1.9 . (текущая директория) была убрана из $LOAD_PATH по соображениям безопасности — require './foo' больше не работает без явного добавления.
• Циклические зависимости через require/require_relative не вызывают ошибку, но константы могут оказаться nil в момент первой загрузки.
• require_relative нельзя использовать в -e однострочниках командной строки.

• Сводить require vs require relative к названию метода без lifecycle и failure path.
• Игнорировать модель runtime: объектная динамическая модель Ruby, где почти всё является объектом, а методы ищутся через ancestor chain.
• Не отделять validation, authorization, transaction boundary и business logic.
• Менять похожие API местами без учёта семантики ошибок и ownership.

• Объясняет require vs require relative через конкретную точку lifecycle в Ruby.
• Приводит корректный минимальный пример без вымышленных методов или callbacks.
• Называет edge cases: пустые значения, ошибки, транзакции, безопасность или concurrency.