Skip to content

Ruby 安装环境和环境搭建

在开始学习Ruby编程之前,我们需要先安装Ruby运行环境。本章将详细介绍如何在不同操作系统上安装Ruby,以及如何配置开发环境。

🖥️ 在不同操作系统上安装Ruby

Windows系统

方法一:使用RubyInstaller(推荐)

  1. 访问RubyInstaller官网
  2. 下载最新版本的Ruby+Devkit安装包
  3. 运行安装程序,按照提示完成安装
  4. 确保勾选"将Ruby添加到PATH环境变量"选项
bash
# 验证安装
ruby -v
# 输出示例: ruby 3.0.0p0 (2020-12-25 revision 95aff21468) [x64-mingw32]

gem -v
# 输出示例: 3.2.0

方法二:使用Chocolatey包管理器

bash
# 安装Chocolatey后执行
choco install ruby

macOS系统

方法一:使用Homebrew(推荐)

bash
# 安装Homebrew(如果尚未安装)
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 安装Ruby
brew install ruby

方法二:使用rbenv版本管理器

bash
# 安装rbenv
brew install rbenv

# 初始化rbenv
rbenv init

# 安装最新版本的Ruby
rbenv install 3.0.0
rbenv global 3.0.0

Linux系统(Ubuntu/Debian)

使用包管理器安装

bash
# 更新包列表
sudo apt update

# 安装Ruby
sudo apt install ruby-full

# 验证安装
ruby -v
gem -v

使用rbenv安装(推荐)

bash
# 安装依赖
sudo apt install git curl libssl-dev libreadline-dev zlib1g-dev autoconf bison build-essential libyaml-dev libreadline-dev libncurses5-dev libffi-dev libgdbm-dev

# 克隆rbenv
git clone https://github.com/rbenv/rbenv.git ~/.rbenv

# 添加到PATH
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc

# 重新加载shell配置
source ~/.bashrc

# 安装ruby-build插件
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

# 安装Ruby
rbenv install 3.0.0
rbenv global 3.0.0

🛠️ 开发工具配置

文本编辑器推荐

Visual Studio Code

  1. 安装VS Code
  2. 安装Ruby扩展包:
    • Ruby
    • Ruby Solargraph
    • Endwise

Sublime Text

  1. 安装Package Control
  2. 安装Ruby相关的包

Atom

  1. 安装ruby-block扩展
  2. 安装language-ruby扩展

IDE推荐

RubyMine

JetBrains出品的专业Ruby IDE,功能强大:

  • 智能代码补全
  • 代码重构
  • 调试器
  • 版本控制集成

VS Code with Ruby扩展

轻量级但功能完整的开发环境。

📦 Ruby包管理器

RubyGems

Ruby的默认包管理器,用于安装和管理Ruby库(称为gems)。

bash
# 查看已安装的gems
gem list

# 安装gem
gem install rails

# 卸载gem
gem uninstall rails

# 更新gem
gem update rails

# 查看gem信息
gem info rails

Bundler

用于管理项目依赖的工具。

bash
# 安装Bundler
gem install bundler

# 初始化Gemfile
bundle init

# 安装Gemfile中指定的依赖
bundle install

# 更新依赖
bundle update

📁 项目结构设置

基本项目结构

my_ruby_project/
├── Gemfile          # 依赖声明文件
├── Gemfile.lock     # 依赖版本锁定文件
├── README.md        # 项目说明文档
├── lib/             # 库文件目录
│   └── my_project.rb
├── bin/             # 可执行文件目录
│   └── my_script
├── spec/            # 测试文件目录
│   └── my_project_spec.rb
└── lib/             # 源代码目录

Gemfile示例

ruby
source 'https://rubygems.org'

gem 'rails', '~> 6.1.0'
gem 'sqlite3', '~> 1.4'
gem 'puma', '~> 5.0'
gem 'sass-rails', '>= 6'
gem 'webpacker', '~> 5.0'
gem 'turbo-rails'
gem 'stimulus-rails'
gem 'bcrypt', '~> 3.1.7'

🔧 环境变量配置

PATH环境变量

确保Ruby和Gem的可执行文件在PATH中:

bash
# 在~/.bashrc或~/.zshrc中添加
export PATH="$HOME/.rbenv/bin:$PATH"
eval "$(rbenv init -)"

RUBY_ENV环境变量

用于设置Ruby环境:

bash
# 开发环境
export RUBY_ENV=development

# 生产环境
export RUBY_ENV=production

# 测试环境
export RUBY_ENV=test

🧪 验证安装

基本验证

bash
# 检查Ruby版本
ruby -v

# 检查Gem版本
gem -v

# 检查Bundler版本
bundle -v

# 检查Ruby安装路径
which ruby

交互式Ruby (IRB)

Ruby自带的交互式解释器,用于快速测试代码:

bash
# 启动IRB
irb

# 在IRB中测试
irb(main):001:0> puts "Hello, Ruby!"
Hello, Ruby!
=> nil

irb(main):002:0> 2 + 3
=> 5

irb(main):003:0> exit

简单测试程序

创建一个简单的Ruby程序来验证安装:

ruby
# hello.rb
puts "Hello, Ruby World!"
puts "Ruby版本: #{RUBY_VERSION}"
puts "平台: #{RUBY_PLATFORM}"

# 运行程序
# ruby hello.rb

🚀 第一个Ruby程序

创建并运行程序

  1. 创建一个新目录用于Ruby项目:
bash
mkdir my_first_ruby_app
cd my_first_ruby_app
  1. 创建第一个Ruby程序:
ruby
# app.rb
# 第一个Ruby程序
class HelloWorld
  def initialize(name)
    @name = name
  end
  
  def greet
    puts "你好, #{@name}! 欢迎来到Ruby世界!"
  end
end

# 创建对象并调用方法
hello = HelloWorld.new("学习者")
hello.greet
  1. 运行程序:
bash
ruby app.rb
# 输出: 你好, 学习者! 欢迎来到Ruby世界!

🔧 常见问题解决

1. 权限问题

bash
# 如果遇到权限问题,使用sudo
sudo gem install bundler

2. 版本冲突

bash
# 使用rbenv管理多个Ruby版本
rbenv versions          # 查看已安装版本
rbenv global 3.0.0      # 设置全局版本
rbenv local 2.7.0       # 设置项目本地版本

3. 网络问题

bash
# 使用国内镜像源
gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/

🎯 最佳实践

1. 使用版本管理器

推荐使用rbenv或RVM来管理Ruby版本,避免系统级安装带来的问题。

2. 使用Bundler管理依赖

始终使用Gemfile来声明项目依赖,确保团队成员使用相同的依赖版本。

3. 配置开发环境

  • 设置合适的编辑器
  • 配置代码格式化工具
  • 安装必要的开发工具

📚 下一步

现在您已经成功安装并配置了Ruby开发环境,接下来可以学习:

继续您的Ruby学习之旅吧!

本站内容仅供学习和研究使用。