CLion 2025.2 Help

编辑器基础

CLion 编辑器是 IDE 的主要部分,您用于创建、阅读和修改代码。

该编辑器包括以下区域:

编辑器详细信息
  1. 当前文件中的 滚动条显示错误和警告。

  2. 路径导航 帮助您在当前文件中导航代码。

  3. 边距显示行号、注释和上下文相关的操作图标。

  4. 选项卡 显示当前打开文件的名称。

  5. 主编辑器区域。

导航

您可以使用各种快捷键在编辑器和不同的工具窗口之间切换、改变编辑器大小、切换焦点或返回到原始布局。

最大化编辑器窗格

  • 在编辑器中,按 Ctrl+Shift+F12。 CLion 隐藏所有窗口,除了活动的编辑器。

    您也可以最大化分屏。 在这种情况下,活动屏幕将最大化,其他屏幕将移到一旁。

将焦点从窗口切换到编辑器

  • 按下 Escape。 CLion 从任何窗口将焦点移动到活动编辑器。

从命令行终端返回编辑器

  • 按下 Alt+F12。 CLion 关闭终端窗口。

  • 如果您在切换回活动编辑器时需要保持终端窗口打开,请按 Ctrl+Tab

跳至最后一个活动窗口

  • 按下 F12

请使用切换器进行导航

  1. 要使用切换器在已打开的文件和工具窗口之间跳转,请按 Ctrl+Tab

  2. 持续按住 Ctrl 以保持切换器弹窗打开。

  3. Tab 在元素之间移动。 按 Backspace 从列表中移除选定的文件并在编辑器中关闭它。

更改 IDE 外观

您可以在方案、键位图和查看模式之间切换。

  1. 按下 Ctrl+`

  2. 切换 菜单中,选择您需要的选项并按 Enter。 使用相同的快捷键 Ctrl+` 撤销您的更改。

您可以在 设置 | 编辑器 | 配色方案 中调整配色方案设置,包括针对视力缺陷人士的 高对比度 配色方案。 要调整键盘映射设置,请转到 设置 | 键位图

  • 按下 Alt+Home

滚动条

当您在编辑器中处理代码时,CLion 会在滚动条上显示代码分析结果,包括错误和警告。 您可以检查代码是否有问题,并快速导航到问题所在。

滚动条顶部有 检查 小部件,为您提供代码问题的简要总结。 点击该小部件以获取有关 问题 工具窗口中每个检测到的问题的更多信息。

文件的代码分析摘要

更多信息,请参见 当前文件的即时分析

滚动条上的条纹表示 CLion 发现问题的地方。 悬停在条纹上将显示描述问题的工具提示,或点击条纹以快速导航。

在处理文件时看到许多条纹是正常的。 许多这些错误、警告和建议都会在您完成代码时最终得到解决。 如果在您认为代码完成时仍然存在错误,我们建议您在编译项目之前检查并解决它们。

条纹的不同颜色表示问题的严重程度,从红色标记的错误到蓝色标记的 TODO 注释,但如果需要,您可以更改显示的颜色。 更多信息请参阅 检查严重性

使用镜头模式

镜头模式允许您在无需滚动至该位置的情况下预览代码。 当您将鼠标悬停在编辑器滚动条上时,将默认启用此功能。 预览会显示代码高亮信息,包括警告和错误,这在处理大型文件时非常有用。

镜头模式
  • 要禁用镜头模式,请右键点击编辑器滚动条,并在上下文菜单中取消选中 悬停在滚动条上时显示代码透镜 复选框。

  • 或者,在 设置 对话框(Ctrl+Alt+S )中,转到 编辑器|常规|外观 ,然后取消选中 悬停在滚动条上时显示代码透镜 复选框。

编辑器标签页

您可以关闭、隐藏并分离编辑器标签。 每次您打开一个文件进行编辑时,一个带有文件名的标签会添加到活动编辑器标签旁边。

要配置编辑器标签的设置,请使用 设置 | 编辑器 | 常规 | 编辑器标签页 页面。 或者,右键点击一个选项卡,然后从选项列表中选择 配置编辑器标签页…

打开或关闭标签页

  • 要关闭所有已打开的选项卡,请从主菜单中选择 窗口 | 编辑器标签页 | 关闭所有标签页

  • 要关闭所有未激活的标签页,请按 Alt 并点击激活的标签页上的 关闭按钮。 在这种情况下,只有活动选项卡保持打开状态。

  • 要关闭除活动标签和 固定标签之外的所有标签,请右键点击任意标签并选择 关闭其他标签页

  • 若要仅关闭活动选项卡,请按 Ctrl+F4。 您还可以点击鼠标的滚轮按钮以关闭选项卡。

  • 要重新打开已关闭的标签页,请右键点击任意标签页并从上下文菜单中选择 Reopen Closed Tab

  • 要打开一个新选项卡并将其置于所有已打开的选项卡的右侧,请在 选项卡设置 中选择 在结尾打开新标签页

复制路径或文件名

  1. 右键点击选项卡。

  2. 从打开的列表中选择 复制路径/引用…

  3. 从打开的列表中选择您的copy option。

    复制路径

    CLion 会将项目复制到剪贴板,您可以在需要的地方粘贴(Ctrl+V)。

移动、移除或排序选项卡

  • 要移动或移除选项卡上的 关闭按钮 图标,请在 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 通用 | 编辑器选项卡 ,并在 关闭按钮位置 字段中选择适当的选项。

  • 要将编辑器选项卡放置在编辑器框架的不同位置或隐藏选项卡,请右键点击一个选项卡并选择 配置编辑器标签页… 以打开 编辑器标签页 设置。 在 显示部分,从 标签页位置 列表中选择适当的选项。

  • 若要查看隐藏的编辑器标签,请点击编辑器中最后一个可见标签旁边的 隐藏选项卡图标

  • 要按字母顺序排序编辑器选项卡,请右键点击选项卡并选择 配置编辑器标签页… 以打开 编辑器标签页 设置。 在 标签页顺序部分,选择 按字母顺序对标签页排序

固定或取消固定标签

您可以固定一个活动编辑器选项卡,这样在达到选项卡限制或使用 关闭其他标签页 命令时它将保持打开。

  • 要固定或取消固定活动标签页,请右键点击它并从上下文菜单中选择 固定标签页取消固定标签

  • 要关闭所有标签页但保留已固定标签页,请右键点击任意标签页并选择 关闭所有未固定的

  • 要为 固定标签页 操作分配键盘快捷键,请在 设置 对话框(Ctrl+Alt+S )中,转到 键位图 ,找到 固定活动标签页 操作,右键点击它,选择 添加键盘快捷键 ,然后按下您想要使用的键组合。

  • 要将固定选项卡保持在左侧,请在 设置 对话框(Ctrl+Alt+S )中,转到 高级设置 ,找到 编辑器选项卡页 部分,并选择 将固定的标签页保持在左侧 选项。

分离标签

当您分离标签页时,标签页会在一个单独的窗口中打开,并且该窗口将专用于该分离的标签页。

如果您尝试将另一个选项卡从主框架中分离出来,它将在已经分离的选项卡的窗口中打开。 您可以将新分离的标签页放置在任意位置(左侧、右侧、底部或顶部)。 您还可以将不同的工具窗口拖动到该框架。

  • 将所需的标签拖出主窗口。 如果您想重新附加该标签页,请将其拖回主窗口。

  • 要分离一个活动标签页,请按 Shift+F4

切换标签页

  • 在选项卡之间移动,请按 Alt+RightAlt+Left

  • 您还可以在最近查看的选项卡或文件之间切换。

    在编辑器中,按下 Ctrl+Tab 并保持按住 Ctrl 以保持 切换器 窗口打开。 请使用 Tab 选择所需的选项卡或文件。

为已打开的标签分配快捷键

  1. 设置 对话框(Ctrl+Alt+S )中,前往 键位图

  2. 在目录列表中,点击 其他 并选择您想要添加快捷方式的目录。 最多可以分配快捷键的选项卡数量为 9。

    添加标签页快捷键

更改默认标签限制

CLion 限制了您可以在编辑器中同时打开的选项卡数量(默认选项卡限制为 10)。

  1. 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 常规 | 编辑器标签页

  2. 关闭策略 部分,根据您的喜好调整设置,然后点击 确定

在预览选项卡中打开文件

预览选项卡允许您逐个在单个选项卡中查看文件,而无需为每个文件打开一个新选项卡。 如果您需要查看多个文件而不超出标签限制,这将非常有用。

  1. Project 工具窗口 Alt+1 中,点击 并选择 行为 | 启用预览标签页

    您还可以在 设置 | 常规 | 编辑器标签页 | 打开策略 中启用预览选项卡。

    启用预览标签页
  2. Project 工具窗口 Alt+1 中,选择一个尚未在其他选项卡中打开的文件。

    文件名是用斜体表示的,以指示预览模式。 您选择的任何其他文件都将替换预览选项卡中的前一个文件。

    在预览标签页中打开的文件

    开始编辑文件或双击文件的标签以退出预览模式,并将预览标签转换为常规标签。

    请注意,当预览选项卡启用时, 一键打开文件 选项将被忽略。 双击文件以在常规选项卡中打开。

显示多个标签页

当您打开超过屏幕容纳量的标签时,您可以将它们放在一行或几行中。

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 编辑器 | 通用 | 编辑器选项卡

  2. 在以下位置显示标签页 部分,选择以下选项之一:

    • 单行,如果标签不适合 :将所有选项卡放在一行,如果选项卡不适合:

      • 滚动标签面板 :将鼠标悬停在选项卡行上并使用出现的滚动条或鼠标滚轮滚动选项卡。 或者,使用右侧的下拉列表 (显示隐藏的选项卡页) 打开视口外的选项卡。

      • 挤压选项卡页 :缩小选项卡以适应屏幕。

    • 多行 :将选项卡放在几行中。

    滚动选项卡
    挤压选项卡页
    多行

更改标签中的字体大小

  1. 设置 对话框(Ctrl+Alt+S )中,转到 外观与行为 | 外观

  2. 大小 字段中,指定字体大小,然后点击 确定 以保存更改。

    请注意,字体大小不仅会影响选项卡,还会影响工具窗口。

面包屑显示从插入符所在的代码元素到文件根元素的路径。 它们有助于跟踪您在 文件结构中的位置。

面包屑的每一部分均可点击,便于导航到父代码元素。 如需获取更多信息,您也可以使用将鼠标悬停在面包屑区域时显示的工具提示。

使用路径导航

  • 单击编辑器中的面包屑可导航到所需的代码元素。

  • 要更改面包屑的位置,请右键点击编辑器中的面包屑,转到 外观 | 路径导航 ,并选择新位置:在编辑器顶部或底部。

    面包屑外观设置
  • 要编辑面包屑的设置、启用或禁用其他语言的面包屑,或更改其外观,请按 Ctrl+Alt+S 打开设置,然后选择 编辑器| 常规| 路径导航

    要隐藏编辑器中的路径导航,请清除 显示路径导航 选项。

分屏

CLion 提供了多种操作,您可以从主菜单或上下文菜单、编辑器或 Project 工具窗口调用这些操作来拆分编辑器屏幕。

  • 在编辑器中,右键点击所需的标签页,选择您希望如何分屏编辑器窗口并移动选定的文件: 向右拆分拆分并右移拆分拆分并下移

    编辑器分屏操作

    CLion 创建编辑器的分屏视图,并根据您的选择放置文件。

    分屏并向右移动结果
  • 或者,从主菜单中选择类似的选项 窗口 | 编辑器标签页

    您还可以为这些操作分配键盘快捷键。 转到 设置 | 键位图 并找到以下操作之一: 向右拆分拆分并右移拆分拆分并下移。 右键点击它,选择 添加键盘快捷键 ,然后按下您想要使用的键组合。

  • 您可以垂直或水平拖动选项卡以分割编辑器,拖回选项卡以取消分屏。

    通过拖动分屏标签页
  • 您可以在右侧拆分中打开编辑器中的文件。

    项目 工具窗口中,右键点击文件,从上下文菜单中选择 在右侧拆分部分打开 (或按 Shift+Enter)。 CLion 会在编辑器右侧的拆分视图中打开文件。

    如果有两个拆分且焦点在左侧拆分,文件将会在现有的右侧拆分中打开。 如果焦点在右侧窗口中,文件将在下一个右侧窗口中打开。

  • 您可以在分屏之间移动文件。 右键点击编辑器中的必要文件标签,然后从上下文菜单中选择 移动到对侧分组在对侧分组中打开

  • 您可以一次性关闭所有打开的工具窗口,从而扩大拆分屏幕。 将文本光标放置在编辑器选项卡上,然后按 Ctrl+Shift+F12 或双击选项卡。 CLion 隐藏所有打开的工具窗口,因此所有空间由分屏共享。

  • 您可以使用 均分比例嵌套分屏 选项等分拆分编辑器。

  • 要取消拆分屏幕,请从上下文菜单中选择 不分割取消所有拆分 以取消所有拆分的框架。

快速弹窗

描述

操作/访问

值得了解

查看符号(标签、类、方法/函数、字段等)的 快速定义

Ctrl+Shift+I

在弹窗中显示符号的定义。 您可以点击 固定按钮 图标以打开 查找 工具窗口,其中包含项目的定义及其用法。

查看代码元素或文件的 快速文档

Ctrl+Q

在弹窗中显示文档。

您可以按两次 Ctrl+Q文档 工具窗口中打开弹窗。 按相同的快捷键切换回弹窗。

如果您想更改弹窗中显示文本的字体大小,请点击 设置 图标并指定新的字体大小。

对于代码元素,您还可以查看 外部文档。 在快速文档弹窗中,点击 上一个 或按 Shift+F1

在查找类时,您可以调用快速文档弹窗 Ctrl+N – 对于列表中显示的任何类。 要将焦点切换到弹窗,请按相同的快捷键。

查看 上下文信息

Alt+Q

当当前方法或类声明不可见时显示其内容。

查看插入符处错误或警告的 描述

Ctrl+F1

点击代码分析标记以查看检测到的错误列表。 使用 F2Shift+F2 导航到下一个或上一个错误。

将工具提示文本复制到剪贴板。

按住 Alt (在 Linux 上,按住 Ctrl+Alt )并点击工具提示。

查看代码元素的所有 用法

Ctrl+Shift+F7

要控制用法高亮显示,请转到 设置 | 编辑器 | 代码编辑 ,并在 插入符移动时高亮 中选择或清除 在插入符号处高亮显示元素的用法 选项。

如果您启用了省电模式(文件 | 节能模式 ),用法将不会被高亮显示。

字体

您可以配置和更改字体、大小和字体连字。 可以将字体大小更改应用于一个编辑器选项卡或全局。

配置字体和字体连字

  1. 设置 对话框 (Ctrl+Alt+S) 中,前往 编辑器 | 字体

  2. 从列表中选择所需字体,并指定其 大小行高。 您还可以启用连字并配置排版设置。

  3. 请点击 确定 以保存更改。

从编辑器更改字体大小

  1. 设置 对话框中(Ctrl+Alt+S ),前往 编辑器 | 常规 (鼠标控制 部分)。

  2. 请选择 使用Ctrl + 鼠标滚轮更改字号 选项。

  3. 返回编辑器,按住 Ctrl ,并使用鼠标滚轮调整字体大小。

在所有选项卡中增加或减少字体大小

  • 在编辑器中,按 Alt+Shift+. 全局增加字体大小,按 Alt+Shift+Comma 减小字体大小。

    CLion 在编辑器底部显示一个缩放指示器,该指示器显示当前字体大小和默认字体大小,您可以回滚到默认值。

  • 默认情况下已启用缩放指示器。 要禁用它,请打开 设置 对话框(Ctrl+Alt+S ),转到 高级设置 ,并在 编辑器 部分中清除 显示缩放指示器 选项。

有用的编辑器配置

您可以使用 编辑器 对话框(Ctrl+Alt+S )中的 设置 部分自定义编辑器的行为。

编辑器设置

查看以下常用配置:

配置代码格式化

  1. 设置 对话框(Ctrl+Alt+S )中,前往 编辑器|代码样式

  2. 从列表中选择适当的语言,并配置制表符和缩进、空格、换行和大括号、硬边距和软边距等设置。

为不同语言和框架配置配色方案设置

  1. 设置 对话框(Ctrl+Alt+S )中,前往 编辑器 | 配色方案

  2. 打开 配色方案 节点并选择所需的语言或框架。 您还可以选择 通用 选项来配置通用项的配色方案设置,例如代码、编辑器、错误和警告、弹出窗口和提示、搜索结果等。

配置代码补全选项

  • 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 常规 | 代码完成。 您可以在此配置区分大小写的自动完成、自动显示选项、代码排序等。

配置文本光标位置

  • 设置 对话框(Ctrl+Alt+S )中,前往 编辑器 | 常规。 在 虚拟空间 部分,配置文本光标放置选项。

    请选择 允许文本光标放置在行末后 选项以将文本光标放置在下一行与前一行结束处相同的位置。 如果清除此选项,下一行的插入位置将放置在该行的末尾。

    选择 允许将文本光标放置在选项卡内 这个选项,以帮助您在文件内上下移动文本光标,同时保持其在相同位置。

配置保存时尾随空格的行为

  • 设置 对话框(Ctrl+Alt+S )中,前往 编辑器 | 常规。 在 其他 部分,配置末尾空格的选项。

    例如,当您手动或自动保存代码,并希望在文本光标所在行保留尾随空格时,无论在 在保存时删除尾随空格 列表中选择了什么选项,请选择 始终保持文本光标所在行的尾部空格 选项。

配置编辑器外观选项

  • 设置 对话框 (Ctrl+Alt+S) 中,前往 编辑器 | 常规 | 外观

    例如,您可以配置 IDE 显示硬换行指示线或参数提示。

管理长行的外观

  1. 设置 对话框 (Ctrl+Alt+S) 中,前往 编辑器 | 常规

  2. 自动换行 部分,指定相应的选项。

    例如,您可以指定 文件类型 ,以应用软换行。 在 markdown 文件中编写文档时,这可能会有所帮助。

配置智能按键

您可以根据使用的语言配置基本编辑器操作的行为。

  • 设置 对话框(Ctrl+Alt+S )中,转到 编辑器 | 常规 | 智能键

    例如,对于 SQL 或 Python,您可以选择 使用 Tab 键跳出闭合括号/引号 选项,以在编写代码时使用 Tab 导航到闭合括号或引号之外。

最后修改日期: 2025年 9月 26日