Ruby安装 #

一、安装前的准备 #

在安装Ruby之前，我们需要了解几种安装方式：

安装方式	优点	缺点	适用场景
系统包管理器	简单快捷	版本可能较旧	临时使用
版本管理器	可安装多版本	需要额外配置	开发推荐
源码编译	完全自定义	复杂耗时	特殊需求
安装包	一键安装	不易切换版本	新手入门

二、版本管理工具 #

2.1 rbenv（推荐） #

rbenv是最流行的Ruby版本管理工具，轻量且不影响系统Ruby。

macOS安装：

bash

brew install rbenv ruby-build

rbenv init
echo 'eval "$(/opt/homebrew/bin/rbenv init - zsh)"' >> ~/.zshrc
source ~/.zshrc

Linux安装：

bash

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build

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

常用命令：

bash

rbenv install -l              rbenv install 3.3.0          rbenv global 3.3.0           rbenv local 3.3.0            rbenv versions               rbenv version                rbenv which ruby

2.2 RVM #

RVM（Ruby Version Manager）是另一个流行的版本管理工具。

安装：

bash

curl -sSL https://get.rvm.io | bash -s stable
source ~/.rvm/scripts/rvm

常用命令：

bash

rvm list known                rvm install 3.3.0            rvm use 3.3.0                rvm use 3.3.0 --default      rvm list                     rvm gemset create myapp      rvm gemset use myapp

2.3 asdf #

asdf是一个通用的版本管理工具，支持多种语言。

安装：

bash

brew install asdf

asdf plugin add ruby
asdf install ruby 3.3.0
asdf global ruby 3.3.0

三、各平台安装指南 #

3.1 macOS安装 #

方法一：Homebrew（简单）

bash

brew install ruby

方法二：rbenv（推荐）

bash

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

3.2 Windows安装 #

方法一：RubyInstaller（推荐）

访问 RubyInstaller官网
下载带Devkit的版本（如Ruby+Devkit 3.3.0）
运行安装程序，勾选"Add Ruby executables to your PATH"
安装完成后打开命令行验证

方法二：WSL（Windows Subsystem for Linux）

bash

wsl --install
sudo apt update
sudo apt install ruby-full

3.3 Linux安装 #

Ubuntu/Debian：

bash

sudo apt update
sudo apt install ruby-full build-essential

CentOS/RHEL：

bash

sudo yum groupinstall "Development Tools"
sudo yum install ruby

Arch Linux：

bash

sudo pacman -S ruby

推荐使用rbenv：

bash

git clone https://github.com/rbenv/rbenv.git ~/.rbenv
git clone https://github.com/rbenv/ruby-build.git ~/.rbenv/plugins/ruby-build
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

四、验证安装 #

安装完成后，验证Ruby是否正确安装：

bash

ruby --version
ruby -v

which ruby

gem --version

预期输出：

text

ruby 3.3.0 (2023-12-25 revision 5124f9ac75) [x86_64-darwin23]
/opt/homebrew/opt/ruby/bin/ruby
3.5.3

五、RubyGems配置 #

RubyGems是Ruby的包管理器，安装Ruby时会自动安装。

5.1 更换国内镜像源（中国大陆用户） #

bash

gem sources --add https://gems.ruby-china.com/ --remove https://rubygems.org/
gem sources -l

5.2 常用gem命令 #

bash

gem install rails            gem install bundler         gem update                  gem update rails             gem list                    gem uninstall rails          gem cleanup                 gem environment

六、Bundler安装 #

Bundler是Ruby项目的依赖管理工具，用于管理项目所需的gem版本。

bash

gem install bundler
bundle -v

使用方法：

bash

bundle init                  bundle install               bundle update               bundle exec ruby app.rb     bundle add rails

七、开发工具推荐 #

7.1 编辑器/IDE #

工具	特点	适用人群
VS Code	免费、插件丰富	大多数开发者
RubyMine	JetBrains出品、功能强大	专业Ruby开发
Sublime Text	轻量快速	喜欢简洁的开发者
Vim/Neovim	高效、可定制	命令行爱好者

7.2 VS Code插件推荐 #

Ruby LSP：官方语言服务器
Ruby Solargraph：智能补全和文档
ruby-rubocop：代码风格检查
Endwise：自动补全end关键字
ERB Formatter：ERB模板格式化

八、常见问题 #

8.1 安装Ruby时编译失败 #

问题：缺少编译依赖

解决：

bash

# macOS
xcode-select --install
brew install openssl readline libyaml

# Ubuntu/Debian
sudo apt install build-essential libssl-dev libreadline-dev zlib1g-dev

# CentOS/RHEL
sudo yum groupinstall "Development Tools"
sudo yum install openssl-devel readline-devel zlib-devel

8.2 gem安装失败 #

问题：安装原生扩展失败

解决：

bash

# macOS
brew install libffi

# Ubuntu/Debian
sudo apt install libffi-dev

# 指定OpenSSL路径
gem install rails -- --with-openssl-dir=/opt/homebrew/opt/openssl

8.3 权限问题 #

问题：gem install需要sudo

解决：使用rbenv或RVM，不要使用系统Ruby

8.4 PATH配置问题 #

问题：ruby命令找不到

解决：

bash

# 检查PATH
echo $PATH

# 添加到配置文件
echo 'export PATH="$HOME/.rbenv/shims:$PATH"' >> ~/.zshrc
source ~/.zshrc

九、开发环境最佳实践 #

9.1 推荐目录结构 #

text

~/projects/
├── ruby/           ├── rails/          └── scripts/

9.2 配置文件 #

创建 ~/.gemrc 文件：

yaml

---
:sources:
  - https://gems.ruby-china.com/
:backtrace: false
:bulk_threshold: 1000
:verbose: true
gem: --no-document

9.3 项目配置 #

每个Ruby项目应该有：

text

my_project/
├── Gemfile             ├── Gemfile.lock       ├── .ruby-version     └── .ruby-gemset

.ruby-version 文件：

text

3.3.0

十、总结 #

本章我们学习了：

版本管理工具：推荐使用rbenv管理Ruby版本
各平台安装：macOS/Linux推荐rbenv，Windows推荐RubyInstaller
RubyGems配置：更换镜像源、常用命令
Bundler安装：项目依赖管理
开发工具：VS Code + Ruby LSP是不错的组合

安装完成后，让我们进入下一章，编写第一个Ruby程序！