设置 Ruby 开发环境
流程概述
本文介绍如何在本地计算机上设置 Ruby 开发环境。 请注意,没有一种流程能够适用于所有平台和目的。 我们仅推荐部分最佳做法,您可根据自身需求和本地计算机的操作系统进行选择。
安装 Ruby
在本主题中,我们专注于 Ruby 的参考实现(Ruby MRI),尽管 RubyMine 也 支持其他实现,如 JRuby 或 TruffleRuby。
有很多选项在 安装 Ruby主题中进行了说明。 需要考虑的关键因素有:
您的操作系统(Linux、macOS、Windows)
首选工具:系统软件包管理器(Homebrew、 atp 等)、Ruby 版本管理器(rbenv、 RVM )和 Ruby 安装程序(ruby-build、 ruby-install)、 RubyInstaller
(面向 Windows)是否计划使用 Rails
如果您难以选择合适的解决方案,我们建议使用以下任一过程。 这些过程使用的是我们认为当前用户中最常见且最直接的方法。
展开与您平台对应的过程以查看详细内容。
在 Linux 上安装 Ruby
此过程说明如何使用被认为是最受欢迎的 Ruby 版本管理器之一的 rbenv 工具,在 Linux 系统上安装 Ruby。 它允许安装不同版本的 Ruby,并可轻松在它们之间切换。
(先决条件)在安装 Ruby 之前,请执行以下操作:
在终端中运行以下命令以更新您的 Linux 发行版:
sudo apt update sudo apt upgrade系统将提示您输入登录名和密码。 输入后,按下 Enter 。 然后在出现提示时,再次按下 Enter 。
通过运行以下命令安装所需的软件包和库:
sudo apt install gcc make libssl-dev libreadline-dev zlib1g-dev libsqlite3-dev libyaml-dev出现提示时,按下 Enter 。 可能需要重新输入您的登录名和密码(然后按下 Enter )。
安装 rbenv:
克隆 rbenv 仓库:
git clone https://github.com/rbenv/rbenv.git ~/.rbenv在系统上设置 rbenv:
~/.rbenv/bin/rbenv init完成后,请关闭终端窗口并重新打开一个新窗口以确保更改生效。
通过运行以下命令安装 ruby-build 插件:
git clone https://github.com/rbenv/ruby-build.git "$(rbenv root)"/plugins/ruby-build安装 Ruby:
(可选)如需查看最新版稳定 Ruby,请在终端中运行以下命令:
rbenv install -l如需安装特定版本的 Ruby,请运行以下命令:
rbenv install {your_ruby_version}通过运行以下命令验证安装是否成功:
ruby -v您应会获得您选择安装的 Ruby 版本。
相关链接
替代方法
在 Linux 上安装 Ruby 的其他常用方法包括使用 Ruby 版本管理器 (RVM) 或 Ubuntu 的 APT 软件包管理器。 更多详情请参见 此处。
在 macOS 上安装 Ruby
Ruby 自 El Capitan(10.11)起已默认包含在 macOS 中。 但这是一个过时的版本,不适用于客户使用。 建议通过版本管理器安装 Ruby,以确保项目所需依赖项的兼容性,并避免权限问题。
此过程说明如何使用被认为是最受欢迎的 Ruby 版本管理器之一的 rbenv 工具,在 macOS 系统上安装 Ruby。 它允许安装不同版本的 Ruby,并可轻松在它们之间切换。
(先决条件)您需要 Xcode IDE 和 Homebrew 软件包管理器。 如果系统中尚未安装这些工具,请执行以下操作:
请在终端中运行以下命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"这将安装 Homebrew,并应自动下载并安装 Xcode。
运行
brew config命令以检查 Homebrew 的安装情况。 请特别确认包含 Xcode 的那一行。如果仍未安装 Xcode,请运行
xcode-select --install命令。
现在您的系统已准备好安装 Ruby。
安装 rbenv:
请运行以下命令:
brew install rbenv安装完成后,请运行以下命令:
rbenv init关闭终端标签页并新开一个,以确保更改生效。
通过运行以下命令验证安装是否成功:
rbenv -v您应会获得系统上已安装的 rbenv 版本。
安装 Ruby:
如需查看最新版稳定 Ruby,请在终端中运行以下命令:
rbenv install -l如需安装特定版本的 Ruby,请运行以下命令:
rbenv install {your_ruby_version}
验证您的 Ruby 安装:
ruby -v您应会获得您选择安装的 Ruby 版本。
相关链接
替代方法
在 macOS 上安装 Ruby 的另一种常用方法是使用 Ruby 版本管理器(RVM)。 更多详情请参见 此处。
在 Windows 上安装 Ruby
在 Windows 上安装 Ruby 有两种常用方法:
RubyInstaller :基于 Windows 的独立安装程序
适用于 Linux 的 Windows 子系统(WSL) :如果您计划使用 Ruby on Rails,推荐使用此方法
在 Windows 上安装 Ruby 有两种常用方法:
RubyInstaller :基于 Windows 的独立安装程序
适用于 Linux 的 Windows 子系统(WSL) :如果您计划使用 Ruby on Rails,推荐使用此方法
选择您偏好的方法选项卡并按照说明操作。
使用 RubyInstaller 工具
转到 此页面并下载所需版本的 Ruby 安装程序。
运行已下载的可执行文件。 将打开 Ruby 安装程序向导。
在向导的第一页中,选中 我接受许可证 复选框并点击 下一步 按钮。
在向导的下一页中,执行以下操作:
指定 Ruby 的安装位置:保留默认选项或指定一个新位置。
请点击 下一步 按钮。
在向导的下一页中,确保选中 MSYS2 开发工具链 复选框并点击 下一步 按钮。 这将启动文件提取过程。
所有文件提取完成后,您将看到向导的最后一页。 保持 运行 ‘ridk install’ 以设置 MSYS2 和开发工具链 复选框处于选中状态并点击 完成 按钮。
一个终端窗口将弹出,并显示 MSYS2 的安装设置。 保留所有默认设置并按下 Enter 。 这将安装所选组件,然后显示带有成功消息的窗口。 再次按下 Enter 。
通过运行以下终端命令验证您的 Ruby 安装:
ruby -v此命令应返回已安装在您系统上的 Ruby 版本。
配置 WSL
从 Microsoft Store 下载并安装一个 WSL 发行版(例如,Ubuntu)。
此步骤请务必使用至少 Windows 10 或更高版本,并安装最新的“秋季创作者更新”(最低版本 1709,构建 16299.15)。 请参阅官方指南 Install the Windows Subsystem for Linux了解详细说明。
要使用 WSL 2 ,您的 Windows 版本应为 10 版本 18917 或更高版本。 请遵循 这些指示来切换分布式。
运行 Linux 发行版。
首次启动时,系统可能会提示您启用 Windows 可选功能。 在这种情况下,您需要执行以下操作:
以管理员身份打开 Windows PowerShell 并运行
Enable-WindowsOptionalFeature -Online -FeatureName Microsoft-Windows-Subsystem-Linux重新启动您的计算机。
(可选) 如果您的 Linux 发行版未附带
rsync,您需要安装它,例如:apt-get install rsyncyum install rsync
既然您可以使用 Linux 命令,请按照 上面的过程安装 Ruby。
在您的系统上安装 Ruby 解释器后,请确保在 RubyMine 中 配置它。
设置 Ruby gem
安装的 Ruby 解释器 配备了一组第三方库。 这些库中的大多数以 gem的形式分发,gem 是可通过名为 RubyGems 的工具安装的打包库或应用程序。 此工具与 Ruby MRI 捆绑提供,因此您通常无需单独安装。 您可以从 官方 Ruby 文档中了解更多关于此工具的信息。
设置 Bundler
若要管理每个项目所需的特定依赖项,您将使用名为 Bundler 的工具。 该工具将在 Gemfiles中列出每个项目的依赖项,这些文件位于各自的项目根目录中。
通常, 已安装的 Ruby 解释器会附带 Bundler,但版本可能与您的项目要求不同。 在这种情况下,RubyMine 会建议安装所需版本。 了解 RubyMine 如何与 Bundler 集成,请参阅 Bundler 主题。
设置 Rails 开发环境
要在 IDE 中处理 Rails 项目,您需要将 rails gem 及其依赖项安装到 Ruby 解释器中。
安装 Rails gem
在 RubyMine 中有几种选项可以实现此操作:
在创建新的 Rails 应用程序时,您可以直接从 新项目向导安装 'rails' gem。
对于现有项目,将“rails” gem 添加到您的 Gemfile 并 使用 Bundler安装。
打开嵌入的 RubyMine 终端仿真器并执行
gem install rails命令。
该过程的下一步是安装 Rails 项目所需的依赖项。
安装 Git
当您 创建一个新的 Rails 项目时,请确保事先安装 Git。 此步骤是必要的,因为 RubyMine 会自动为所有新的 Rails 项目创建本地 Git 仓库。
安装数据库工具
Rails 开发在很大程度上依赖于使用关系型数据库。 Rails 中最常用的数据库管理系统(DBMS)是 SQLite、MySQL 和 Postgres。 若要使用所需的 DBMS,我们建议使用您的系统软件包管理器安装相应的软件包。 例如,要安装 Postgres,请使用以下命令之一:
macOS
brew install postgresqlLinux(包括适用于 Windows 的 WSL)
sudo apt install postgresql postgresql-contrib
安装 JavaScript 工具
Rails 应用程序可以包含用以下方式管理的 JavaScript 模块:
Webpacker :一个 Webpack 的封装 gem——这是一个最受欢迎的的工具,用于管理和打包 JavaScript 代码。
Asset Pipeline :在 Rails 中处理 JavaScript 和 CSS 资源的传统框架。
请注意,从 Rails 6 开始,Webpacker 是默认的 JavaScript 编译器。 要在您的应用程序中使用 Webpacker,您需要安装以下工具:
之后,您可以直接从 RubyMine 安装 JavaScript 依赖项并处理您的 JavaScript 代码。