第一章：环境安装

1. 安装 Ruby 3.3

Ruby 3.3 带来了 YJIT 性能改进和更好的解析器 Prism。根据你的操作系统选择对应的安装方式。

macOS（Homebrew）

macOS 自带系统 Ruby（版本较旧），推荐用 Homebrew 安装最新版：

brew install ruby

如果需要管理多个 Ruby 版本，推荐使用 rbenv：

brew install rbenv ruby-build
rbenv install 3.3.0
rbenv global 3.3.0

# 将 rbenv 初始化添加到 shell 配置
echo 'eval "$(rbenv init -)"' >> ~/.zshrc
source ~/.zshrc

Ubuntu / Debian

Ubuntu 官方源通常版本较旧，推荐用 rbenv 安装：

# 方式一：系统包（版本可能不是最新）
sudo apt install ruby-full

# 方式二：rbenv（推荐，可安装任意版本）
sudo apt install git curl libssl-dev libreadline-dev zlib1g-dev
curl -fsSL https://github.com/rbenv/rbenv-installer/raw/HEAD/bin/rbenv-installer | bash
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
source ~/.bashrc

rbenv install 3.3.0
rbenv global 3.3.0

Windows

Windows 推荐使用 RubyInstaller，它捆绑了 MSYS2 开发工具链：

# 从 https://rubyinstaller.org/ 下载 Ruby+Devkit 版本
# 安装时勾选 "Add Ruby executables to your PATH"
# 安装完成后在弹出的窗口中选择 MSYS2 and MINGW 开发工具链（选项 3）

验证安装

$ ruby -v
ruby 3.3.0 (2023-12-25 revision 5124f9ac75) [arm64-darwin23]

$ gem -v
3.5.3

2. IRB 交互式环境

IRB（Interactive Ruby）是 Ruby 自带的交互式 REPL，可以逐行执行 Ruby 代码，非常适合快速实验和调试。

$ irb
irb(main):001> 1 + 2
=> 3
irb(main):002> "Hello, Ruby".upcase
=> "HELLO, RUBY"
irb(main):003> [1, 2, 3].map { |n| n * 10 }
=> [10, 20, 30]
irb(main):004> { name: "Ruby", year: 1995 }.keys
=> [:name, :year]
irb(main):005> exit

Ruby 3.x 的 IRB 内置了语法高亮、自动补全和多行编辑支持。还可以用 irb --simple-prompt 使用精简提示符。

3. 安装 Bundler

Bundler 是 Ruby 的依赖管理工具，通过 Gemfile 声明项目依赖，确保团队使用一致的 gem 版本。Ruby 2.6+ 已默认捆绑 Bundler。

# 如果系统未自带或需要更新
gem install bundler

# 确认版本
bundler -v

初始化项目

mkdir my-ruby-project && cd my-ruby-project
bundle init

这会生成一个 Gemfile，编辑它来添加依赖：

source "https://rubygems.org"

gem "httparty", "~> 0.21"
gem "nokogiri", "~> 1.16"
gem "pry", group: :development

# 安装所有依赖
bundle install

# 运行项目中的 Ruby 脚本（自动加载 Bundler 环境）
bundle exec ruby app.rb

4. Hello World

创建一个 hello.rb 文件，体验 Ruby 的基本语法：

name = "Ruby"
version = 3.3
features = ["YJIT", "Pattern Matching", "Ractor", "Fiber Scheduler"]

puts "Hello, #{name} #{version}!"

puts "Ruby 3.x 核心特性："
features.each_with_index do |feature, i|
  puts "  #{i + 1}. #{feature}"
end

def greet(who)
  "欢迎学习 #{who}！"
end

puts greet("Ruby 3.3")

3.times { puts "Ruby is fun!" }

numbers = [1, 2, 3, 4, 5]
squares = numbers.map { |n| n ** 2 }
puts "平方：#{squares.inspect}"

$ ruby hello.rb
Hello, Ruby 3.3!
Ruby 3.x 核心特性：
  1. YJIT
  2. Pattern Matching
  3. Ractor
  4. Fiber Scheduler
欢迎学习 Ruby 3.3！
Ruby is fun!
Ruby is fun!
Ruby is fun!
平方：[1, 4, 9, 16, 25]

5. VS Code 配置

VS Code 是 Ruby 开发的主流编辑器。安装以下扩展可以获得出色的开发体验：

推荐在项目中添加 .vscode/settings.json：

{
    "editor.formatOnSave": true,
    "[ruby]": {
        "editor.defaultFormatter": "Shopify.ruby-lsp",
        "editor.tabSize": 2
    },
    "rubyLsp.formatter": "auto",
    "rubyLsp.yjit": true
}

6. 本章要点