RubyMine 2025.2 Help

国际化与本地化

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

遵循 i18n 约定,RubyMine 会自动加载存储在 config/locales 目录中的字典文件(YAML 或 Ruby)。 如果需要,您可以提供自定义路径。 为此,请打开 设置 对话框 Ctrl+Alt+S ,转到 项目结构 页面并切换到 I18n 选项卡。

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

创建区域属性

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

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

    <h1><%= t('.welcome') %></h1>
  2. 将光标放在 .欢迎 键上,然后按 Ctrl+F1 查看警告:

    缺失键警告
  3. 然后,按 Alt+Enter ,选择 创建属性 并按 Enter

    创建区域属性
  4. 在调用的对话框中,选择一个区域文件并指定属性值:

    创建属性对话框

    使用 add 按钮为其他区域添加翻译。 然后,单击 确定 在字典文件中创建指定的翻译:

    yaml 本地化键
  5. 您可以从 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 并选择 更改预览语言环境

    更改预览区域
  3. 查看所需键的所有可用翻译的另一种方法是按 Ctrl+Q快速文档查找):

    区域键的快速文档
最后修改日期: 2025年 9月 26日