llms.txt: machine-readable documentation index. Markdown version of this page is also available.

CLion 2026.3 Help

代码格式化

CLion 可根据您在当前 代码样式方案或 .editorconfig 文件中指定的要求重新格式化代码。 如果在 .editorconfig 未定义任何内容,则将从项目设置中获取。

您可以重新格式化部分代码、整个文件、一组文件、一个目录和一个模块。 您还可以从重新格式化中排除部分代码或某些文件。

格式化代码片段

  1. 在编辑器中选择您要重新格式化的代码片段。

  2. 在主菜单中,前往 代码 | 格式化代码 或按下 Ctrl+Alt+L。

重新格式化文件

  1. 在编辑器中打开文件并按下 Ctrl+Alt+Shift+L ,或在 项目 工具窗口中右键点击文件并选择 重新格式化代码。

  2. 在打开的 重新格式化文件 对话框中,您可以根据需要选择以下重新格式化选项:

    重新格式化文件对话框
    • 代码清理 :选择此选项以运行代码清理检查。

    • 不要保留换行符 :根据代码样式设置重新格式化换行符。 此选项仅当在 设置 | 编辑器 | 代码样式 | <语言> | 换行和大括号 中为当前语言启用 重新格式化时保留 | 换行符 时可用。 如果选择 不要保留换行符 ,IDE 会临时重写该设置,并根据当前代码样式移除现有换行。

      还可以使用 再次重新格式化以移除自定义换行 选项(位于 设置 | 编辑器 | 智能键 中)。

  3. 点击 运行。

    如果您想查看代码在重新格式化期间所做的确切更改,请使用 本地历史记录 功能。

重新格式化行缩进

您可以根据指定的设置重新格式化行缩进。

  1. 在编辑器中,选择必要的代码片段并按 Ctrl+Alt+I。

  2. 如果您需要调整缩进设置,请在 设置 对话框(Ctrl+Alt+S )中,转到 编辑器|代码样式。 选择您要更改缩进的语言。

  3. 在 制表符和缩进 选项卡上,指定适当的缩进选项,然后点击 确定。

保存时自动重新格式化代码

您可以配置 IDE,在修改文件的代码在更改 保存时自动重新格式化。

  1. 按下 Ctrl+Alt+S 打开设置,然后选择 工具 | 保存时的操作。

  2. 启用 重新设置代码格式 选项。

  3. 此外,您可以配置 IDE 重新格式化代码的方式:

    • 点击 配置作用域… 以指定您要 排除在重新格式化之外的文件名和目录的模式。

    • 从 所有文件类型 列表中选择您要重新格式化代码的文件类型。

    • 如果您的项目在版本控制中,请选择 整文件 或 更改的行数。

      如果您选择 更改的行数 ,代码重格式化将仅适用于本地更改但尚未提交到存储库的代码行。

在提交时重新格式化代码

如果您的项目在 版本控制下,您可以在提交更改到存储库时自动重新格式化代码。 在这种情况下,仅会重新格式化新增或修改的代码。

  1. 按 Alt+0 打开 提交 工具窗口,然后点击 显示提交选项 设置按钮。

  2. 在 提交检查 菜单下,启用 重新设置代码格式 选项。

启用该选项后,每次提交时,新增或修改的代码都会被重新格式化。

排除文件格式化

您可以将一组文件和目录排除在重新格式化和导入优化之外。

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

  2. 切换到 格式化器 选项卡,在 不要进行格式设置。 字段中,使用 glob 模式输入您想要排除的文件和目录。

    您可以指定用分号 ; 分隔的几个通配符模式。 如果您点击 展开图标 ,该字段将展开,每个模式将显示在单独的行上。

  3. 应用更改并关闭对话框。

    指定一个 glob 模式以排除文件格式化

在编辑器中排除代码片段的重格式化

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

  2. 切换到 格式化器 标签并启用 在代码注释中使用标记开启或关闭格式化程序 选项。

  3. 在编辑器中,您希望排除的区域开头创建行注释 Ctrl+/ 并输入 @formatter:off。 在该区域的末尾,创建另一行注释并输入 @formatter :on。

    标记之间的代码不会重新格式化。

2026年 11月 6日