Что такое gems и Bundler?

Question

Accepted Answer

**Gems** — это пакеты (библиотеки) Ruby, распространяемые через RubyGems. **Bundler** управляет зависимостями gem-пакетов проекта — устанавливает правильные версии и обеспечивает **согласованные, воспроизводимые** окружения на разных машинах с помощью lockfile. Вместе они используются для управления зависимостями в проектах Ruby.

## Gems — пакеты Ruby

```bash
gem install rails          # install a gem globally
gem list                   # list installed gems
# gems come from rubygems.org — the central package registry (Rails, RSpec, etc.)
```

Gem — это упакованная библиотека Ruby (код + метаданные). RubyGems — это менеджер пакетов, а rubygems.org — реестр, эквивалент npm/pip для Ruby.

## Bundler — управление зависимостями проекта

```ruby
# Gemfile — declares your project's gem dependencies
source "https://rubygems.org"

gem "rails", "~> 7.0"        # version constraint (~> allows compatible updates)
gem "pg"                     # PostgreSQL adapter
gem "rspec", group: :test    # only in the test environment
```

```bash
bundle install               # install all gems from the Gemfile (creates Gemfile.lock)
bundle update                # update gems to newer allowed versions
bundle exec rspec            # run a command with the project's exact gem versions
```

**`Gemfile`** объявляет зависимости вашего проекта с ограничениями версий. `bundle install` устанавливает их и генерирует **`Gemfile.lock`**.

## Lockfile — воспроизводимые установки

```text
Gemfile      → declares dependencies with constraints (e.g. rails ~> 7.0)
Gemfile.lock → records the EXACT versions of every gem (and sub-dependency) installed
→ COMMIT Gemfile.lock → everyone (team, CI, production) gets the IDENTICAL versions.
  Prevents "works on my machine" bugs from version differences.
```

**`Gemfile.lock`** фиксирует точные версии каждого gem-пакета (включая транзитивные зависимости), поэтому его коммит гарантирует, что все разработчики, CI и production установят *идентичное* дерево зависимостей — воспроизводимые, согласованные окружения. Всегда коммитьте его.

## bundle exec — используйте версии проекта

```bash
bundle exec rspec    # runs rspec using the EXACT versions in Gemfile.lock
# (vs `rspec` which might use a different globally-installed version)
```

## Почему это важно

Gems и Bundler — это фундамент разработки на Ruby — это то, как практически все Ruby-проекты управляют зависимостями, поэтому их понимание необходимо. **Gems** (пакеты Ruby из rubygems.org) предоставляют библиотеки и фреймворки (Rails, RSpec и т.д.), от которых зависят реальные приложения, а **Bundler** — это стандартный инструмент для управления ими в проекте.

Основная ценность Bundler — и самая важная концепция для понимания — это **воспроизводимые, согласованные окружения**: **`Gemfile`** объявляет зависимости с ограничениями версий, а **`Gemfile.lock`** фиксирует *точные* версии каждого gem-пакета (включая транзитивные зависимости), которые были установлены.

Коммит `Gemfile.lock` гарантирует, что все — вся команда, CI и production — установят идентичное дерево зависимостей, предотвращая ошибки типа "работает на моей машине", которые возникают из-за различий в версиях.

Эта воспроизводимость критична для надёжной, совместной разработки и развёртывания.

Понимание gems (пакетов Ruby), Gemfile (объявление зависимостей), `bundle install`, **lockfile и зачем его коммитить** (воспроизводимые установки — центральная выгода) и `bundle exec` (запуск команд с точными версиями проекта) — это важные, ежедневные знания для любого Ruby-проекта.

Поскольку управление зависимостями — это фундамент реальных приложений, а поскольку lockfile-ориентированная воспроизводимость Bundler — это то, как Ruby-команды обеспечивают согласованные окружения на разработке, CI и production, овладение gems и Bundler — аналогично npm/package-lock.json в Node — это необходимое, часто применяемое знание для профессиональной разработки на Ruby.