依赖管理 #

# 没有 Bundler 的问题
# 项目 A 需要 rails 6.0
# 项目 B 需要 rails 7.0
# 全局安装会冲突

# 使用 Bundler
# 每个项目独立的依赖环境
bundle install --path vendor/bundle

1. 读取 Gemfile 中的依赖声明
2. 获取所有可用版本
3. 解析依赖关系图
4. 选择满足所有约束的版本组合
5. 写入 Gemfile.lock

# Gemfile
gem 'rails', '~> 7.0'
gem 'sidekiq', '~> 7.0'

# 解析过程
# 1. rails ~> 7.0 需要 actionpack ~> 7.0
# 2. actionpack ~> 7.0 需要 activesupport ~> 7.0
# 3. sidekiq ~> 7.0 需要 redis ~> 5.0
# 4. 选择满足所有约束的版本

# 悲观约束 (~>)
gem 'rails', '~> 7.0.0'  # 7.0.x，不升级到 7.1
gem 'rails', '~> 7.0'    # 7.x，不升级到 8.0

# 范围约束
gem 'rails', '>= 7.0', '< 8.0'

# 精确版本
gem 'rails', '7.0.4'

# 安装所有依赖
bundle install

# 安装到项目目录
bundle install --path vendor/bundle

# 安装到系统目录
bundle install --system

# 安装时跳过生产依赖
bundle install --without production

# 安装特定分组
bundle install --with development test

# 部署模式安装（生产环境推荐）
bundle install --deployment

# 等同于
bundle install --path vendor/bundle --without development test --clean

# 使用 4 个并行任务
bundle install --jobs 4

# 自动检测 CPU 核心数
bundle install --jobs $(nproc)

# 更新所有依赖
bundle update

# 更新特定 Gem
bundle update rails

# 更新多个 Gem
bundle update rails sidekiq

# 只更新 patch 版本
bundle update --patch

# 只更新 minor 版本
bundle update --minor

# 只更新 major 版本
bundle update --major

# 保守更新（优先使用已安装版本）
bundle update --conservative

# 严格更新（严格遵循版本约束）
bundle update --strict

# 更新 Bundler
bundle update --bundler

# 更新到特定版本
bundle update --bundler 2.4.0

1. 记录精确的版本号
2. 记录依赖树结构
3. 记录下载源
4. 记录平台信息
5. 确保团队一致性

GEM
  remote: https://rubygems.org/
  specs:
    actionpack (7.0.4)
      actionview (= 7.0.4)
      activesupport (= 7.0.4)
    rails (7.0.4)
      actionpack (= 7.0.4)

GIT
  remote: https://github.com/rails/rails.git
  revision: abc123
  specs:
    rails (7.1.0.alpha)

PATH
  remote: ../my_gem
  specs:
    my_gem (1.0.0)

PLATFORMS
  ruby
  x86_64-linux

DEPENDENCIES
  rails (~> 7.0)
  my_gem!

BUNDLED WITH
   2.4.0

# 检查是否最新
bundle check

# 查看依赖树
bundle show

# 查看特定 Gem
bundle show rails

# 查看依赖路径
bundle show rails --paths

# 安装到项目目录
bundle install --path vendor/bundle

# 目录结构
project/
├── vendor/
│   └── bundle/
│       └── ruby/
│           └── 3.2.0/
│               ├── gems/
│               └── specifications/
├── Gemfile
└── Gemfile.lock

# 在 Bundle 环境中运行
bundle exec ruby app.rb
bundle exec rails server
bundle exec rspec

# 不使用 bundle exec 可能的问题
# 使用系统安装的 Gem 版本
# 可能与项目依赖不一致

# 生成 binstubs
bundle binstubs rails

# 使用 binstubs
bin/rails server
bin/rspec

# 添加到 PATH
export PATH="./bin:$PATH"

# Gemfile
group :development do
  gem 'pry'
  gem 'rubocop'
end

group :test do
  gem 'rspec'
  gem 'factory_bot'
end

group :development, :test do
  gem 'pry-byebug'
end

group :production do
  gem 'puma'
  gem 'sentry-ruby'
end

# 排除分组
bundle install --without development test

# 包含分组
bundle install --with development

# 多个分组
bundle install --without development test production

# 在代码中加载特定分组
Bundler.require(:default, :development)

# 条件加载
Bundler.require(:default, Rails.env)

# 指定平台
gem 'tzinfo-data', platform: :windows

# 多个平台
gem 'ffi', platform: [:mingw, :x64_mingw]

# 平台块
platforms :ruby do
  gem 'pg'
end

platforms :jruby do
  gem 'activerecord-jdbcpostgresql-adapter'
end

# 查看当前平台
bundle platform

# 显示详细平台信息
bundle platform --ruby

# 检查依赖是否满足
bundle check

# 检查并显示缺失
bundle check --dry-run

# 检查过时的 Gem
bundle outdated

# 只检查特定 Gem
bundle outdated rails

# 只检查 patch 更新
bundle outdated --patch

# 只检查 minor 更新
bundle outdated --minor

# 只检查 major 更新
bundle outdated --major

# 显示依赖树
bundle show

# 显示详细依赖
bundle show --verbose

# 生成依赖图
bundle viz

# 生成 PNG 图片
bundle viz --format=png

# 查看 Gem 信息
bundle info rails

# 查看 Gem 路径
bundle info rails --path

# 查看 Gem 版本
bundle info rails --version

# 清理未使用的 Gem
bundle clean

# 强制清理
bundle clean --force

# 干运行
bundle clean --dry-run

# 清理旧版本 Gem
gem cleanup

# 清理特定 Gem
gem cleanup rails

# 干运行
gem cleanup --dryrun

# 查看依赖树
bundle viz

# 查看特定 Gem 依赖
gem dependency rails

# 强制解析
bundle update --conservative

# 查看可用版本
gem search rails --all

# 安装特定版本
bundle update rails -v 7.0.4

# 强制更新
bundle update rails --force

# 使用镜像源
bundle config set mirror.https://rubygems.org https://gems.ruby-china.com

# 使用代理
bundle config set proxy http://proxy.example.com:8080

# 增加超时
bundle install --retry 5

# 查看配置
bundle config

# 设置配置
bundle config set path 'vendor/bundle'

# 设置全局配置
bundle config set --global path 'vendor/bundle'

# 设置本地配置
bundle config set --local path 'vendor/bundle'

# 删除配置
bundle config unset path

# .bundle/config
---
BUNDLE_PATH: "vendor/bundle"
BUNDLE_JOBS: "4"
BUNDLE_RETRY: "3"
BUNDLE_WITHOUT: "development:test"

# 设置安装路径
bundle config set path 'vendor/bundle'

# 设置并行数
bundle config set jobs 4

# 设置重试次数
bundle config set retry 3

# 排除分组
bundle config set without 'development test'

# 设置镜像源
bundle config set mirror.https://rubygems.org https://gems.ruby-china.com

# 设置部署模式
bundle config set deployment true

# 设置清理模式
bundle config set clean true

name: CI

on: [push, pull_request]

jobs:
  test:
    runs-on: ubuntu-latest
    
    steps:
      - uses: actions/checkout@v3
      
      - name: Set up Ruby
        uses: ruby/setup-ruby@v1
        with:
          ruby-version: '3.2'
          bundler-cache: true
          
      - name: Install dependencies
        run: bundle install --jobs 4 --retry 3
        
      - name: Run tests
        run: bundle exec rspec
        
      - name: Run linter
        run: bundle exec rubocop

test:
  image: ruby:3.2
  
  cache:
    paths:
      - vendor/bundle
      
  before_script:
    - bundle install --path vendor/bundle --jobs 4 --retry 3
    
  script:
    - bundle exec rspec
    - bundle exec rubocop

version: 2.1

jobs:
  test:
    docker:
      - image: cimg/ruby:3.2
        
    steps:
      - checkout
      
      - restore_cache:
          keys:
            - bundle-v1-{{ checksum "Gemfile.lock" }}
            
      - run:
          name: Install dependencies
          command: bundle install --path vendor/bundle
          
      - save_cache:
          key: bundle-v1-{{ checksum "Gemfile.lock" }}
          paths:
            - vendor/bundle
            
      - run:
          name: Run tests
          command: bundle exec rspec

# 推荐：允许 minor 更新
gem 'rails', '~> 7.0'

# 不推荐：无约束
gem 'rails'

# 不推荐：过于严格
gem 'rails', '7.0.4.1'

# 清晰的分组
group :development, :test do
  gem 'pry'
  gem 'rspec'
end

group :production do
  gem 'puma'
end

# 始终提交 Gemfile.lock
git add Gemfile.lock

# 定期更新依赖
bundle update

# 安全更新
bundle update --patch

# 安装审计工具
gem install bundler-audit

# 检查安全漏洞
bundle audit

# 更新漏洞数据库
bundle audit update