Gems 和 Bundler 是什么？

Question

Gems 和 Bundler 是什么？

Accepted Answer

**Gems** 是通过 RubyGems 分发的 Ruby 包（库）。**Bundler** 管理项目的 gem 依赖——安装正确的版本，并通过锁定文件确保**一致、可重现的**环境跨机器。它们是 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 是注册表——Ruby 相当于 npm/pip。

## 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`**。

## 锁定文件 — 可重现的安装

```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 和生产环境安装*相同的*依赖树——可重现、一致的环境。始终提交它。

## 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**（来自 rubygems.org 的 Ruby 包）提供真实应用依赖的库和框架（Rails、RSpec 等），**Bundler** 是在项目中管理它们的标准工具。

Bundler 提供的关键价值——也是最重要的概念——是**可重现、一致的环境**：**`Gemfile`** 使用版本约束声明依赖，**`Gemfile.lock`** 锁定*确切的*版本，包括安装的每个 gem（和传递依赖）。

提交 `Gemfile.lock` 保证每个人——整个团队、CI 和生产环境——都安装相同的依赖树，防止由版本差异引起的