RubyMine 2026.3 Help

创建并运行您的第一个 Ruby 项目

本主题说明如何在 RubyMine 中执行以下操作:

  • 创建您的第一个空应用程序

  • 创建并运行 Ruby 文件

  • 创建并运行您的第一个 Rails 应用程序

  • 向 Rails 应用程序添加 JavaScript 资源

  • 运行添加了 JavaScript 资源的 Rails 应用程序

在执行以下过程之前,请下载并安装 Ruby 发行版 ,并设置 IDE。

我们将使用安装在 macOS 上的 RubyMine 执行所有过程。

创建您的第一个应用程序

在本章中,您将学习如何创建空应用程序、添加 Ruby 文件并运行该文件。

创建一个空应用程序

  1. 运行 RubyMine 并点击 新建项目 在 欢迎界面。

    欢迎屏幕
  2. 在 新建项目 对话框中,确保左侧窗格中选择了 空项目。 然后,指定以下设置:

    新建项目对话框 / 空
    • 名称 :为项目指定一个名称(在我们的示例中为 ruby_helloworld)

    • Location :指定您希望创建项目的目录路径。 默认情况下,RubyMine 会创建一个与项目同名的目录。

    • 解释器 :选择系统中安装的所需 Ruby 解释器。

  3. 点击 创建 继续。

创建一个 Ruby 文件

创建项目后,您将在左侧的项目工具窗口中看到其结构。 要添加一个 Ruby 文件,请执行以下操作:

  1. 在“项目”工具窗口中选择一个项目根目录,然后按 Alt+Insert。

  2. 在调用的弹出窗口中,选择 Ruby 文件/类 并按 Enter。

    新建 Ruby 类
  3. 在弹出的窗口中,指定脚本名称(在本例中为 script ),然后点击 确定。

    新建 Ruby 文件/类
  4. 在编辑器中插入以下代码:

    puts "Please enter your name" name = gets.chomp puts "Hello, #{name}! I'm Ruby!"

运行 Ruby 脚本

要运行创建的脚本,请执行以下操作:

  1. 按 Ctrl 两次并输入以下命令:

    ruby script.rb

    按下 Enter。

    运行 ruby 脚本
  2. 在运行工具窗口中,输入任意名称并按 Enter 以查看程序响应。

运行/调试配置

运行 Ruby 脚本后,RubyMine 会自动创建一个特殊的配置文件,即运行/调试配置。 此类配置文件用于运行、调试和测试应用程序,并指定脚本名称、工作目录、启动前要执行的操作等。

要编辑配置,请在 运行 小部件下调用下拉菜单并选择 编辑配置。

编辑配置

在弹出的 运行/调试配置 对话框中,您可以指定启动脚本所需的设置。

运行/调试配置

有关运行/调试配置的更多信息,请参阅 本主题。

创建一个 Rails 应用程序

在本章中,您将学习如何创建 Rails 应用程序并运行该应用程序。

  1. 运行 RubyMine 并点击 新建项目 在 欢迎界面。

    欢迎屏幕
  2. 在 新建项目 对话框中,左侧窗格 项目类型 组的 Rails 组 Ruby on Rails 中选择 应用程序 ,并指定以下设置:

  3. 指定以下设置:

    新建项目对话框:Rails 应用程序
    • 名称 :为项目指定一个名称(在我们的示例中为 rails-helloworld)。

    • Location :指定您希望创建项目的目录路径。 默认情况下,RubyMine 会创建一个与项目同名的目录。

    • 解释器 :选择您希望在项目中使用的 Ruby 解释器。

    • Rails 版本 :选择您希望在项目中使用的 Rails 版本。 如果所选解释器中未安装 Rails gem 或缺少所需的 Rails 版本,请单击字段中的 安装 Rails Gem 按钮。 等待 RubyMine 下载所有可用的 Rails 版本,然后从下拉列表中选择所需版本。 点击 确定 继续。

      安装 Rails gem

      如果所选版本尚未安装,RubyMine 会在创建项目时安装它。

    • 额外选项 :在 额外选项 字段中提供用于项目创建的额外 Rails 选项。

      例如,您可以指定通常用于附加到 rails new(新建) 命令的 参数: --skip-tests(跳过测试) 跳过测试文件的创建, --skip-action-mailer(跳过 Action Mailer) 跳过 Action Mailer 文件, --skip-action-cable(跳过 Action Cable) 跳过 Action Cable 文件,等等。

      要获取与所用 Rails 版本兼容的 Rails 选项的完整列表,请运行 rails new --help(帮助) 命令。

  4. 点击 创建 关闭 新建项目 对话框。

  5. RubyMine 创建一个新的 Rails 应用程序,安装 Gemfile 中提到的 gem 依赖项,并安装项目 package.json 文件中提到的 JavaScript 依赖项。 您可以在 Run 工具窗口中看到此过程。

    为项目生成 Rails 应用程序
  6. 安装所有依赖项后,您可以在左侧的 Project 工具窗口(Alt+1 )中查看项目结构。 在右侧,RubyMine 会自动在编辑器中打开主要的项目文件。

    全新的 Rails 应用程序

    如果您的操作系统中安装了 Git,生成一个新的 Rails 应用程序时也会初始化一个 Git 仓库。 您可以从 版本控制 部分学习如何在 RubyMine 中使用版本控制系统。

  7. 现在我们有一个运行正常的 Rails 应用。 要查看其效果,您需要启动一个 web 服务器。 执行以下步骤来完成此操作:

    1. 单击右上角的 运行 图标。

    2. RubyMine 将展示准备运行应用程序的过程。

      Rails 服务器输出
    3. 在浏览器中打开 http://127.0.0.1:3000 ,即可查看 Rails 的默认信息页面。

      Rails 默认页面

向 Rails 应用程序添加 JavaScript 资源

本章说明如何向 Rails 项目添加 JavaScript 资源并运行应用程序,以查看其工作方式。 我们将使用在上一过程中创建的空 Rails 应用程序。 以下步骤假定您已经创建了 此项目 ,并已在编辑器中将其打开。

添加控制器

  1. 请按 Ctrl 两次并开始键入 controller。 在调用的列表中,选择 rails generate controller 并按 Enter。

    rails g controller
  2. 在调用的 添加新控制器 对话框中,将控制器名称设置为 Welcome ,并添加一个名为 index的操作。 点击 确定。

    添加新控制器
  3. RubyMine 将创建一个控制器、视图及其他几个文件。 此过程将显示在 Run 工具窗口中。 在此窗口中,点击 index.html.erb 文件。

    生成脚本输出
  4. 要将应用程序的首页设置为 索引 ,请打开 config/routes.rb 文件,并在 Rails.application.routes.draw do ... end 块中添加以下行:

    root 'welcome#index'

    了解更多信息,请参见 Setting the Application Home Page。

更新视图

在已创建的视图中添加一个按钮。

  1. 在 Project 视图(Alt+1 )中,打开 app/views/welcome/index.html.erb 文件。

  2. 用以下代码替换文件中现有内容:

    <h1>Hello, Rails!</h1> <button id="greet-user-button">Hello!</button>

    除了 h1 标记中的现有 static 文本外,视图文件现在还包含一个具有特定标识符、将被 JavaScript 使用的按钮元素。

添加 JavaScript 处理程序

现在,创建一个用于处理按钮点击的 JavaScript 文件。

  1. 在 Project 视图中,选择 应用/JavaScript 目录。

  2. 按 Alt+Insert 并选择 JavaScript 文件。

    新建文件
  3. 指定文件名称(hello ),然后按 Enter。

    新建 JavaScript 文件
  4. 在创建的 hello.js 文件中,添加以下代码:

    const button = document.getElementById("greet-user-button") if (button) { button.addEventListener("click", () => { alert("Hello!, JavaScript!") }) }

    在该脚本中:

    • 通过标识符查找按钮。

    • 添加点击处理程序,使其显示警告并将消息日志输出到控制台。

  5. 为了让该文件在应用程序中可用,请打开 应用/JavaScript/应用程序.js 并添加:

    import "hello"
  6. 请确保应用程序布局包含 JavaScript 资源。 打开 应用/视图/布局/应用程序.html.erb 并确认其包含:

    <%= javascript_importmap_tags %>
  7. 打开 配置/导入映射.rb 文件并添加以下行:

    pin "hello"

启动网络服务器

要查看我们的应用程序运行效果,您需要启动 Web 服务器。

  1. 按 Ctrl 两次并开始键入 开发。

  2. 单击右上角的 运行 图标。

  3. RubyMine 将展示准备运行应用程序的过程。

    Rails 服务器输出
  4. 在浏览器中打开 http://127.0.0.1:3000 。 然后点击 您好! 按钮即可看到警告。

    Rm new js browser click
2026年 11月 9日