RubyMine 2025.1 Help

代码补全

基本代码补全帮助您补全类、方法和关键字的名称,这些名称在可见范围内。

RubyMine 分析上下文并建议从当前光标位置可达的选项。 建议还包括 Live templates。 补全支持非英语键盘布局。

调用基本补全

  • 默认情况下,RubyMine 会在您输入时自动显示代码补全弹出窗口。

    或者,您可以按 Ctrl+Space 或从主菜单中选择 代码 | 代码补全 | 基本

    基本补全
  • 声明名称补全
  • 代码补全可用于 custom file types。 但是,RubyMine 无法识别此类文件的结构,并会建议选项,而不考虑它们在当前上下文中的适用性。

从列表中接受一个建议

  • Enter 或双击相关列表项,将其插入到光标左侧。

  • 请按 Tab 替换插入点右边的字符。

  • 使用 Ctrl+Shift+Enter 使当前代码结构在语法上正确(平衡括号、添加缺失的大括号和分号等)。

  • 使用特定键和自定义字符接受选定的补全建议。 要启用这些功能,请转到 编辑器 | 常规 | 代码完成 设置页面  Ctrl+Alt+S 并执行以下操作:

    1. 要使用特定键,请选中 通过按空格键、点号或其他上下文相关的键插入选定的建议 复选框。 这些键取决于语言、您的上下文等因素。

    2. 若要使用自定义字符,请将字符输入到 接受完成的附加字符 字段。

Hippie 补全

Hippie completion 是一个补全引擎,它分析您在可见范围内的文本并根据当前上下文生成建议。 它可以帮助您完成任何当前打开的文件中的任何单词。

将文本光标处的字符串扩展为现有单词

  1. 输入初始字符串,然后执行以下操作之一:

    • Alt+/ 或选择 代码 | 代码补全 | Cyclic Expand Word 搜索光标前的匹配词。

    • Alt+Shift+/ 或选择 代码 | 代码补全 | 循环展开单词(向后) 以在文本光标后和其他打开的文件中搜索匹配的单词。

    第一个建议值出现,而且原型在源代码中被高亮显示。

    扩展单词
  2. 接受建议,或者按住 Alt 键并继续按 \ ,直到找到您需要的单词。

标签和属性的补全

RubyMine 自动完成多种文件类型中的标签和属性名称及值:

完整的标签名称

  1. 请输入开头 < 然后开始输入标签名。 RubyMine 显示在当前上下文中适用的标签名称列表。

    标签完成

    使用 UpDown 键滚动列表。

  2. Enter 来接受列表中的选择。 如果您的文件与架构或 DTD 相关联,RubyMine 将自动根据其插入必需的属性。

导入 taglib 声明

如果您需要使用在标签库中声明的标签,您需要在使用该标签库中的任何自定义标签之前导入此 taglib。

  1. 开始输入 taglib 前缀,然后按 Alt+Insert

  2. 从列表中选择一个 taglib 然后按 Enter

    RubyMine 自动导入所选的 taglib 并添加 import 语句。

在一个 taglib 中声明一个标签

  1. 开始键入标签,然后按 Ctrl+Alt+Space

  2. 从列表中选择一个标签。 标签库的 uri 显示在括号中。

    标签完成:之前
  3. 请选择一个 taglib 然后按 Enter。 RubyMine 会添加所选标签库的声明。

机器学习辅助的补全排序

RubyMine 允许您根据其他用户在类似情况下的选择来优先考虑补全建议。

ML 补全机制不会添加任何新元素,而是对从代码中检索的元素进行排序。 数据不会暴露在任何地方;它是在本地收集的。

启用 ML 补全排序

  1. Ctrl+Alt+S 打开设置并选择 编辑器 | 常规 | 代码完成

  2. 机器学习辅助补全 下,启用 根据机器学习对补全建议进行排序 选项并选择您希望使用 ML 补全的语言。

    ML 辅助补全设置

启用相关性标记

  1. Ctrl+Alt+S 打开设置并选择 编辑器 | 常规 | 代码完成

  2. 启用以下选项:

    • 在补全弹出窗口中标记位置更改 :使用 机器学习排名提升机器学习排名降序 图标来指示建议的重要性是增加还是减少,因此建议已在建议列表中上移或下移。

    • 在补全弹出窗口中标记最相关的条目 :请使用 与机器学习相关的建议 图标标识列表中最合适的建议。

    建议列表将如下显示,图标标记重新排序和最相关的条目。

    ML 辅助补全

配置代码补全设置

要配置代码补全选项,请转到 编辑器 | 常规 | 代码完成 设置页面&#xa0; Ctrl+Alt+S

您可以选择以下设置:

项目

描述

区分大小写

选择是否要考虑字母大小写来提供代码补全建议。 选择是匹配首字母的大小写还是所有字母的大小写。

自动插入单个建议到

如果对基础和智能类型匹配补全只有一个建议,则自动完成代码。

按字母顺序对建议排序

选择是否按字母顺序排序建议列表中的项,而不是按相关性排序。

您可以随时通过点击建议列表中的 并切换 按名称排序 选项来更改此行为。

输入时显示建议

选择是否希望建议列表自动弹出,而无需明确调用补全功能。 此选项默认已启用。

通过按空格、点或其他上下文相关键插入选定建议

选择是否通过输入根据语言、上下文等因素确定的特定键来插入所选建议。

以下时间后显示文档弹出窗口

选择自动显示弹出窗口,其中包含建议列表中当前突出显示的类、方法或字段的文档。

在右侧字段中,指定弹出窗口应出现的延迟时间(以毫秒为单位)。

适用时自动插入圆括号

如果启用此选项,RubyMine 将在您完成函数或方法时自动插入一对开闭括号。

取消选中该复选框以禁止自动插入括号。

如果您使用一个开括号 ( 而不是 Enter 从完成列表中应用选定项,那么无论该选项是否打开,括号都会自动插入。

要使用开括号 ( 而不是 Enter 来应用补全列表中的选定项目,请打开 设置 对话框(Ctrl+Alt+S ),转到 编辑器 | 常规 | 代码完成 ,并选中 通过按空格、点或其他上下文相关键插入选定建议 复选框。

如需更多信息,请参阅 Use specific keys to insert suggestions

完成提示和技巧

缩小建议列表

  • 通过输入单词的任何部分(甚至是中间的字符)或在点分隔符后调用代码补全来缩小建议列表范围。

    RubyMine 显示包含您输入的字符的建议,无论它们的位置如何。 这使得不再需要使用通配符。

    代码补全通配符

    对于 CamelCasesnake_case 名称,请仅输入首字母。 RubyMine 会自动识别和匹配首字母。

    代码补全通配符

查看参考

  • 您可以在建议列表中选择一个条目时,按 Ctrl+Shift+I 使用 快速定义视图

    补全快速定义
  • 您可以通过按 Ctrl+Q 使用 快速信息视图 ,当您在建议列表中选择一个条目时:

    快速文档

查看代码层次结构

当您从建议列表中选择一个条目时,您可以查看代码层次结构:

  • Ctrl+H :查看类型层次结构

  • Ctrl+Shift+H :查看方法层次结构。

故障排查

如果代码补全不起作用,可能是以下原因之一:

  • 省电模式 在 (文件 | 省电模式)。 开启它可以通过消除后台操作(包括错误高亮、即时检查和代码补全)来最大限度地减少笔记本电脑的电量消耗。

  • 未为您的项目配置解释器。

  • 您的文件不在内容根目录中,因此无法获得代码补全所需的类定义和资源。

  • 包含您希望出现在补全建议列表中的类和函数的文件被标记为纯文本文件。

  • 包含您希望出现在补全建议列表中的函数的外部库未被 添加为依赖项或全局库

  • 如果收集代码补全选项花费的时间太长,代码补全弹出窗口可能不会自动出现。 例如,如果计算机正在忙于其他任务。 在这种情况下,您仍然可以通过 Ctrl+Space 手动激活代码补全弹出窗口。

最后修改日期: 2025年 7月 22日