RubyMine 2026.2 Help

国际化与本地化

RubyMine 支持多种功能,帮助您对 Rails 应用程序和纯 Ruby 项目进行国际化和本地化。 您可以直接在编辑器中使用意图操作创建或编辑区域属性,运行检查以查找缺失的键,预览本地化值等。 这些功能适用于各种项目文件类型,包括 Ruby 脚本、HTML、ERB 和 HAML 文件。

我们将使用 示例 Rails 应用程序 展示 IDE 的国际化功能。 您可以通过 检出 此应用程序重复以下步骤。

管理本地化文件

遵循 i18n 约定,RubyMine 会自动加载存储在 config/locales 目录中的字典文件(YAML 或 Ruby)。 创建项目时,会默认创建 en.yml 文件。

添加自定义本地化文件夹

可以提供自定义本地化文件夹的路径。

  1. 打开 设置 对话框 Ctrl+Alt+S

  2. 前往 项目结构 页面并切换到 I18n 选项卡。

  3. 点击 Add 图标以打开文件浏览器。

  4. 选择所需的文件夹。

添加字典文件

  1. 转到 config/locales Project 视图中。

  2. 在工具窗口工具栏上的 新建文件或目录 上点击(Alt+Insert ),并从文件类型列表中选择 File

  3. 新建文件 对话框中指定名称,例如 ger.yml ,然后按输入键。

新文件创建为空。 可以通过手动添加键值对或按照下方过程通过专用对话框创建本地化属性。

创建区域属性

RubyMine 提供了一个检查功能,用于查找在任何区域中都不存在的键。 要查看此功能的实际效果,请执行以下操作:

  1. 打开 app/views/static_pages/home.html.erb 文件并向下滚动到以下代码:

    <h1>Welcome to the Sample App</h1>
  2. 将其替换为以下代码:

    <h1><%= t('.welcome') %></h1>
  3. 将鼠标悬停在 .欢迎 密钥上以查看警告:

    缺失键警告
  4. 点击 创建属性

  5. 在弹出的对话框中指定属性值:

    创建属性对话框
  6. 使用 add 按钮为其他区域添加翻译。

    添加翻译
  7. 然后点击 确定 ,在字典文件中创建指定的翻译:

    yaml 本地化键
  8. 可以 导航t 方法中调用的密钥到字典中的对应密钥。

    导航到键

提取硬编码字符串

RubyMine 使您能够将硬编码字符串提取到区域文件中。 要使用 示例 Rails 应用程序 尝试此功能,请执行以下操作:

  1. 打开 app/views/static_pages/home.html.erb 项目文件并向下滚动到以下代码:

    <%= link_to "Sign up now!", signup_path, class: "btn btn-lg btn-primary" %>
  2. 将光标放在 “立即注册!” 字符串上,按 Alt+Enter 并选择 I18nize 硬编码字符串 操作。 按下 Enter

  3. 创建属性 对话框中,指定键并提供所需的翻译:

    创建属性对话框

    点击 确定。 RubyMine 将在区域文件中添加相应的属性,并用为创建的键调用的 t 方法替换初始字符串:

    <%= link_to t('.signup'), signup_path, class: "btn btn-lg btn-primary" %>

查看区域值

RubyMine 提供了显示本地化值而不是 I18n 键的功能。 要使用 示例 Rails 应用程序 尝试此功能,请执行以下操作:

  1. 将光标放在所需的键上,然后按 Ctrl+. 折叠它:

    预览区域属性

    预览将显示系统默认区域的值。

  2. 要使用其他区域预览值,请按 Alt+Enter 并选择 更改预览语言环境

    更改预览区域
2026年 7月 14日