# 高级设置

> For the complete documentation index, see [llms.txt](https://www.jetbrains.com/zh-cn/help/clion/llms.txt).

> **TL;DR**
> `文件 | 设置 | 高级设置`  适用于 Windows 和 Linux
>
>
>
> `%instance% | 设置 | 高级设置`  适用于 macOS
>
>
>
> `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS)) !["设置"图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg)

除了您经常使用的标准设置外，CLion 还提供了多种高级选项，您可以用来微调特定产品功能的行为。

由于高级设置包含不同的部分，可以使用搜索字段快速跳转到感兴趣的部分或所需选项。 您还可以搜索注册表键，因为某些高级选项有对应的注册表键。

## Angular

|  项  |  描述  |
| --- | --- |
|    在编辑器中显示导航弹出窗口    |     选中此复选框后，CLion 会显示一个导航弹窗，可帮助快速在 Angular 组件内的文件之间跳转、在一个文件中导航到样式和模板，或打开相关文件列表的弹窗。      [Video](https://resources.jetbrains.com/help/img/idea/2026.3/ws_angular_navigation_popup.mp4)  |

## CMake

使用此部分为 [CMake](quick-cmake-tutorial.html)项目配置其他选项。

|  项  |  描述  |
| --- | --- |
|    对于 CMake 3.20 及更高版本使用旧版生成器    |      对于 CMake 版本 3.20 及更高版本 ，CLion 默认使用带有 Ninja [生成器](cmake-profile.html#cmake-generators) 的 CMake 文件 API。 如果选中此复选框，默认生成器将是 Makefiles，CLion 仅在您指定自定义生成器时才会切换到 CMake 文件 API。        对于旧版本 ，CMake 文件 API 仅在使用自定义生成器的情况下启用，无论此选项的状态如何。 默认生成器是 Makefiles。     |
|    不要自动触发 CMake 重新加载    |  选择此选项以完全禁用 CMake 项目的自动重新加载，包括外部更改。 请参阅 [加载/重新加载 CMake](reloading-project.html)。  |
|    首次打开项目时执行初始配置文件配置    |  如果您希望 CLion 在首次打开项目时不自动配置并显示默认的 [CMake 配置文件](cmake-profile.html)，请清除此复选框。  |
|    按顺序重新加载 CMake 配置文件    |  如果您希望 CLion 依次 [重新加载](reloading-project.html) CMake 配置文件，请选择此选项。 默认情况下，CMake 配置文件是并行重新加载的，但有时在重新加载 CMake 时可能会导致问题。 使用此选项解决此类问题。  |
|    自动导入 CMake Presets    |  默认情况下，CLion 会自动将检测到的配置和构建 [预设](cmake-presets.html) 导入到 [CMake 配置文件](cmake-profile.html) 中。 使用切换器更改此行为：   ![CMake 预设启用选项](https://resources.jetbrains.com/help/img/idea/2026.3/cl_advancedsettings_cmake_presets.png)     * 配置和构建 - 默认选项。    * 配置 - 仅导入配置预设。    * 构建 - 仅导入构建预设。    * 无 - 禁用预设导入。 现有的基于预设的配置文件将在下次重新加载 CMake 或重新打开项目时被删除。    |
|    使用浮动工具栏通知需要重新加载 CMake 项目    |     默认情况下，当您在 [CMakeLists.txt](cmakelists-txt-file.html) 中进行更改时，CLion 会显示一个浮动通知，指示需要重新加载项目。 您可以通过清除此复选框来禁用浮动通知。       有关更多信息，请参阅 [在 CMakeLists.txt 中更改时重新加载 CMake](reloading-project.html#manual-reload)。     |
|    在 CMake 调试器中使用 DAP 协议    |     此选项默认已启用。 对于 [CMake 调试](cmake-debug.html) 版本 3.27 及更高版本，CLion 使用 [调试适配器协议](https://microsoft.github.io/debug-adapter-protocol/) (DAP)。       清除此复选框以切换到基于 [Sysprogs 的 CMake 脚本调试器](https://sysprogs.com/w/introducing-cmake-script-debugger/) 的实现。     |
|    将 Python 解释器传递给 CMake    |     此选项为所有项目启用 [Python 与 CMake 的集成](python-interpreter-for-cmake-projects.html)。       默认启用。     |

## 外观

|  项  |  描述  |
| --- | --- |
|    启用 Islands UI 以使用自定义主题    |  为从 JetBrains Marketplace 安装的 [自定义 UI 主题](https://plugins.jetbrains.com/docs/intellij/supporting-islands-theme.html)启用 Islands UI 元素，如圆角和分区。 默认情况下，Islands UI 仅应用于 [内置 Islands 主题](user-interface-themes.html)。  |

## 书签

|  项  |  描述  |
| --- | --- |
|    仅在弹出窗口中显示行书签    |  默认情况下，CLion 只在书签弹出窗口中显示行书签（ `Shift+F11` (Windows), `⌘ F3` (macOS), `⇧ F11` (IntelliJ IDEA Classic (macOS)), `⌘ ⌃ K` (macOS System Shortcuts), `Shift+F11` (XWin), `Shift+F11` (GNOME), `Shift+F11` (KDE), `Shift+F11` (Emacs), `Shift+F11` (Sublime Text), `Shift+F11` (Sublime Text (macOS)), `⌘ F3` (Xcode), `Ctrl+`` (Visual Studio), `⌃ `` (Visual Studio (macOS)), `Ctrl+`` (ReSharper), `⌃ `` (ReSharper (macOS)), `Alt+M` (QtCreator), `⌃ ⌥ M` (QtCreator (macOS)), `Ctrl+Shift+M` (NetBeans), `Shift+F11` (Eclipse), `⌘ F3` (Eclipse (macOS)) 或  `编辑 \| 书签 \| 显示行书签…` ）。 如果您希望在弹出窗中看到其他书签项目，例如文件或文件夹，请禁用此选项。 如需了解更多信息，请参阅 [书签](bookmarks.html)。  |
|    分支切换时恢复书签上下文    |  默认情况下，CLion 为每个 VCS 分支维护独立的书签上下文。 切换分支时，将恢复为该分支设置的书签。 禁用此选项以尽可能在分支切换时保留书签。 欲了解更多信息，请参阅 [切换分支时保留书签。](bookmarks.html#bookmarks-vcs-branches)。  |

## 构建工具。 Gradle

|  项  |  描述  |
| --- | --- |
|    使用 Gradle 运行    |     此选项默认情况下会被选中。 构建和运行操作将由 Gradle 执行。 如果清除此选项，CLion 将构建并运行项目。     |
|    下载源代码    |     默认情况下，CLion 在初始项目同步时不会下载项目依赖项的源代码。       选择此选项以更改项目的行为，并在导入过程中始终下载依赖项的来源。     |
|    附加脚本依赖项源    |     在 Gradle 项目导入期间，此选项会为你的构建脚本依赖项（即 build.gradle 文件的 buildscript  `{ dependencies { ... } }`  块中声明的 classpath 条目）关联源 JAR。       启用此选项后，IDE 会下载并关联构建脚本本身所用插件和库的源代码——不是项目的运行/编译依赖项，而是构建脚本依赖的 Gradle 插件和工具。 这样可以直接在 IDE 中进入它们的源代码。 启用后需进行项目同步才能关联源代码。     |

## 代码补全

|  项  |  描述  |
| --- | --- |
|    启用输入时自动补全功能。    |  输入时自动显示补全建议。 禁用后，仅当按下 `Alt+Shift+\` (Windows), `⌥ ⇧ \` (macOS), `⌥ ⇧ \` (IntelliJ IDEA Classic (macOS)), `⌥ ⇧ \` (macOS System Shortcuts), `Alt+Shift+\` (XWin), `Alt+Shift+\` (GNOME), `Alt+Shift+\` (KDE), `Alt+Shift+\` (Emacs), `Alt+Shift+\` (Sublime Text), `⌥ ⇧ \` (Sublime Text (macOS)), `⌥ ⇧ \` (Xcode), `Alt+Shift+\` (Visual Studio), `⌥ ⇧ \` (Visual Studio (macOS)), `Alt+Shift+\` (ReSharper), `⌥ ⇧ \` (ReSharper (macOS)), `Alt+Shift+\` (QtCreator), `⌥ ⇧ \` (QtCreator (macOS)), `Alt+Shift+\` (NetBeans), `Alt+Shift+\` (Eclipse), `⌥ ⇧ \` (Eclipse (macOS)) 时才显示建议。  |

## 代码审查工具

|  项  |  描述  |
| --- | --- |
|    代码审查的一体化差异    |  选择此选项可在一个可滚动的差异视图中处理代码审查中所有更改的文件。  |
|    为差异线程保留增加的边距    |  取消选中此选项可减少代码审查中注释周围的水平空间。  |

## 容器环境：WSL、Docker

|  项  |  描述  |
| --- | --- |
|    获取环境变量的 Shell 模式    |  使用此选项可控制 IDE 启动 shell 以读取容器和远程环境（如 WSL 和 Docker）的环境变量。 可选择 shell 是否以交互式模式（默认）或非交互式模式启动。 这决定了哪些 shell 启动文件会被执行，从而决定哪些环境变量可供 IDE 使用。  |

## 数据库

|  项  |  描述  |
| --- | --- |
|    如果由脚本加载器检测到，则以表格形式打开文件    |     对于 [scripted data loaders](data-loaders.html) 支持的文件格式。 定义 CLion 在表格视图中打开的文件。        * 全部 ：所有支持的表格数据文件。    * 表格优先格式 ：表示表格格式数据的文件格式。 目前，除 JSON 之外支持所有表格数据文件格式。    * 无 ：禁用所有文件的视图。    |
|    相关行操作行为    |     定义在表格单元格的浮动工具栏或上下文菜单中调用   相关行   操作时的行为。        * 导航与筛选全部 ：仅显示引用的行。    * 导航并选择第一个 ：显示对应表中的所有行，并选中引用行中的第一行。    |
|    在“Search Everywhere”中显示“数据库”选项卡    |     启用   数据库   选项卡在   Search Everywhere   中（双击 `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Xcode), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (ReSharper), `Shift` (ReSharper (macOS)), `Shift` (QtCreator), `Shift` (QtCreator (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS))）。       有关“随处搜索”功能的更多信息，请参阅 [全局搜索](searching-everywhere.html)。     |

## 调试器

|  项  |  描述  |
| --- | --- |
|    最近表达式的最大数量    |     指定要保存到历史记录中的表达式数量。 这包括各种字段，例如 [评估表达式](examining-suspended-program.html#evaluate-arbitrary) 和   转到地址   在 [反汇编](disassembly-view.html) / [内存](memory-view.html) 视图中。     |
|    显示嵌入式“运行到光标处”弹出窗口    |  启用此选项后，您可以将鼠标悬停在希望继续执行的代码行上，然后利用 [运行到光标](stepping-through-the-program.html#run-to-cursor) 弹出窗口执行代码，直到到达光标所在的行。  |
|    在附加后保持进程挂起    |  启用此选项后，您 [附加](attach-to-process.html) 的进程将保持挂起状态。  |
|    为调试会话准备 GDB 索引    |     如果您遇到 GDB 性能问题，请选中此复选框。       启用此选项后，CLion 会在调试会话之前为 GDB 准备 [索引](https://sourceware.org/gdb/current/onlinedocs/gdb.html/Index-Files.html)。 首次启用此选项后启动时，仅可执行文件会被索引。 之后，CLion 会检测加载的库，并在后续调试会话中将其与可执行文件一起索引。 这意味着启用索引后的第一次调试会话可能仍然较慢，但后续会话应该会更快。       该选项适用于从 IDE 启动的 Linux 机器上的可执行文件。     |
|    当文本光标改变时在浏览器中高亮显示当前元素    |     使用此复选框配置调试会话期间在浏览器中的高亮显示。        * 默认情况下，复选框被选中时，当文本光标移动到编辑器中的相应代码段，浏览器中的元素将高亮显示。    * 清除此复选框后，按住 `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Xcode), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (ReSharper), `Shift` (ReSharper (macOS)), `Shift` (QtCreator), `Shift` (QtCreator (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS))并在编辑器中悬停元素即可在浏览器中高亮显示该元素。    |

## 开发容器

|  项  |  描述  |
| --- | --- |
|    使用 --depth=1 克隆源代码    |  使用此选项通过检出最新版本的源代码来加速您的项目克隆过程。 如需更多信息，请参阅 [Git 文档](https://git-scm.com/docs/git-clone)。  |
|    自动选择后端版本    |  选择此选项后，将自动选择最新版本的 IDE 。  |
|    如果开发容器后端/前端的部署耗时超过 10 秒，则显示通知    |  选择此选项后， IDE 会显示通知。  |
|    重建 Docker Compose 开发容器时使用 '--no-recreate'。 Main 服务将始终被重新创建。    |  选择此选项后，即使您使用  `--no-recreate`  选项以避免重建未更改的容器，也会重新创建主开发容器。  |

## Docker

|  项  |  描述  |
| --- | --- |
|    重启时自动连接 Docker    |  CLion 启动后 [连接到已配置的 Docker daemon](docker.html#connect_to_docker)。  |
|    镜像仓库实体加载限制    |  出于性能原因，默认情况下，CLion 仅显示 [Docker registry](docker-images.html#configure-registry) 中的前 100 张图片。 如果您需要列出更多，请增加此数字。 这也会增加内存使用量。  |
|    日志选项卡应作为 Docker 容器的第一个选项卡。    |  将   日志   选项卡显示为 [容器概览窗格](docker-containers.html#interacting-with-containers) 中的第一个选项卡。  |
|    用于自动重连的周期性 Docker 状态检查之间的延迟    |  CLion 应该多久检查一次与 Docker 的连接状态（以毫秒为单位）。  |
|    在 SELinux 系统中对几乎所有绑定卷应用 :z 挂载选项    |  在 SELinux 工作站上添加  `:z`  配置标志到 Docker 绑定挂载以 [将卷连接到 Docker 容器](docker-containers.html#bind_mounts_selinux)。  |

## 编辑器

请使用本部分来配置在 [编辑器](using-code-editor.html) 中工作的其他选项。

|  项  |  描述  |
| --- | --- |
|    使用撤消透明文本光标移动    |  若希望像常规文本编辑器一样立即撤销上次编辑，请选择此选项。  |
|    在无选择情况下调用复制或剪切操作时，不复制/剪切当前行    |  此选项允许您覆盖在编辑器中未选择任何内容时复制 [默认行为](null)或剪切 `Ctrl+C` (Windows), `⌘ C` (macOS), `⌘ C` (IntelliJ IDEA Classic (macOS)), `⌘ C` (macOS System Shortcuts), `Ctrl+C` (XWin), `Ctrl+C` (GNOME), `Ctrl+C` (KDE), `Ctrl+Insert` (Emacs), `Ctrl+C` (Sublime Text), `⌘ C` (Sublime Text (macOS)), `⌘ C` (Xcode), `Ctrl+C` (Visual Studio), `⌘ C` (Visual Studio (macOS)), `Ctrl+C` (ReSharper), `⌘ C` (ReSharper (macOS)), `Ctrl+C` (QtCreator), `⌘ C` (QtCreator (macOS)), `Ctrl+C` (NetBeans), `Ctrl+C` (Eclipse), `⌘ C` (Eclipse (macOS))当前整行的 `Ctrl+X` (Windows), `⌘ X` (macOS), `⌘ X` (IntelliJ IDEA Classic (macOS)), `⌘ X` (macOS System Shortcuts), `Ctrl+X` (XWin), `Ctrl+X` (GNOME), `Ctrl+X` (KDE), `Shift+Delete` (Emacs), `Ctrl+X` (Sublime Text), `⌘ X` (Sublime Text (macOS)), `⌘ X` (Xcode), `Ctrl+X` (Visual Studio), `⌘ X` (Visual Studio (macOS)), `Ctrl+X` (ReSharper), `⌘ X` (ReSharper (macOS)), `Ctrl+X` (QtCreator), `⌘ X` (QtCreator (macOS)), `Ctrl+X` (NetBeans), `Ctrl+X` (Eclipse), `⌘ X` (Eclipse (macOS))默认行为。  |
|    在未选择内容的情况下调用复制操作后，不选择已复制的行    |  默认情况下，如果您在不选择任何内容的情况下使用 `Ctrl+C` (Windows), `⌘ C` (macOS), `⌘ C` (IntelliJ IDEA Classic (macOS)), `⌘ C` (macOS System Shortcuts), `Ctrl+C` (XWin), `Ctrl+C` (GNOME), `Ctrl+C` (KDE), `Ctrl+Insert` (Emacs), `Ctrl+C` (Sublime Text), `⌘ C` (Sublime Text (macOS)), `⌘ C` (Xcode), `Ctrl+C` (Visual Studio), `⌘ C` (Visual Studio (macOS)), `Ctrl+C` (ReSharper), `⌘ C` (ReSharper (macOS)), `Ctrl+C` (QtCreator), `⌘ C` (QtCreator (macOS)), `Ctrl+C` (NetBeans), `Ctrl+C` (Eclipse), `⌘ C` (Eclipse (macOS))，整行内容将被复制。 通过此操作，您可以避免该选择。  |
|    粘贴未选择内容时复制的行    |  您可以更改默认的   粘贴到插入符号行上方  行为，并选择   粘贴到插入点行  ，该行为恢复旧版的复制/粘贴行为，或者选择   如果粘贴到中间行则进行修剪  ，此行为将在中间粘贴时移除复制行前后的不必要空格。  |
|    使用其 Unicode 名称缩写渲染特殊字符，例如控制码    |  选中此选项后，您可以使用 Unicode 名称缩写表示特殊字符，例如控制代码。  |
|    显示缩放指示器    |  在编辑器中 [缩放](using-code-editor.html#increase_decrease_font) 您的代码（放大或缩小）时，使用此选项可查看一个指示器，显示当前字体大小，并提供将其恢复为默认值的选项。  |
|    制表符字符渲染    |     您可以选择以下选项之一：        * 水平线    * > 符号    * 长箭头    |
|    剩余边距（免费模式）下的剩余边距。    |     此选项允许您在 [无干扰和禅模式](ide-viewing-modes.html)中调整左侧编辑器边距。       默认情况下，这些查看模式下的编辑器文本垂直居中，文本列宽对应于   在以下位置硬包装  选项，在   编辑器｜代码样式  设置页面 `Ctrl+Alt+S` (Windows), `⌘ Comma` (macOS), `⌘ Comma` (IntelliJ IDEA Classic (macOS)), `⌘ Comma` (macOS System Shortcuts), `Ctrl+Alt+S` (XWin), `Ctrl+Alt+S` (GNOME), `Ctrl+Alt+S` (KDE), `Ctrl+Alt+S` (Emacs), `Ctrl+Alt+S` (Sublime Text), `⌘ Comma` (Sublime Text (macOS)), `⌘ Comma` (Xcode), `Ctrl+Alt+S` (Visual Studio), `⌘ Comma` (Visual Studio (macOS)), `Ctrl+Alt+S` (ReSharper), `⌘ Comma` (ReSharper (macOS)), `Ctrl+Alt+S` (QtCreator), `⌘ Comma` (QtCreator (macOS)), `Ctrl+Alt+S` (NetBeans), `Ctrl+Alt+S` (Eclipse), `⌘ Comma` (Eclipse (macOS))。 这意味着如果您的代码在 [正确格式化](null)时会居中，但如果有长的未换行行，文本可能会在左侧有大空白的情况下超出视口。 在这种情况下，您可能希望使用此选项减少左边距。     |
|    行号的字体增量    |  使用此选项可以更改左侧边栏中行号的字体大小，使其与编辑器中的字体大小进行比较。  |
|    在行长度超过  `n`  个字符的文档中强制软换行    |  默认数量是  `100000` 。 将此数字增加可能会对编辑器性能产生负面影响。  |
|    使用“扩展选择”选择空白字符    |  使用此选项在调用 [扩展选择](working-with-source-code.html#editor_code_selection) 操作时包含空格。  |
|    使用行注释操作添加注释后，将文本光标向下移动    |  此选项允许您配置是否在 [对行使用行注释注释行](null) `Ctrl+/` (Windows), `⌘ /` (macOS), `⌘ /` (IntelliJ IDEA Classic (macOS)), `⌘ /` (macOS System Shortcuts), `Ctrl+/` (XWin), `Ctrl+/` (GNOME), `Ctrl+/` (KDE), `Alt+;` (Emacs), `Ctrl+/` (Sublime Text), `⌘ /` (Sublime Text (macOS)), `⌘ /` (Xcode), `Ctrl+Alt+/` (Visual Studio), `⌘ ⌥ /` (Visual Studio (macOS)), `Ctrl+/` (ReSharper), `⌘ /` (ReSharper (macOS)), `Ctrl+/` (QtCreator), `⌘ /` (QtCreator (macOS)), `Ctrl+/` (NetBeans), `Ctrl+/` (Eclipse), `⌘ /` (Eclipse (macOS))时将文本光标移动到下一行。 请注意，如果编辑器中有选择内容，无论此选项如何，文本光标都不会移动。  |

## 编辑器选项卡页

除了 CLion 在编辑器中 [使用选项卡](using-code-editor.html#manage_tabs)时提供的标准 [编辑器标签选项](settings-editor-tabs.html)外，本节还包含一些作为内部注册表操作提供的额外选项。

|  项  |  描述  |
| --- | --- |
|    导航到文件时，优先选择非活动分割窗格中已有的选项卡    |  当您导航到一个已经在非活动拆分中打开的文件时，请使用此选项以在该拆分窗格中激活现有文件，而不是在活动拆分中打开文件的新副本。  |
|    在同一选项卡中打开声明源文件    |  当您导航到方法、类或变量时，包含其声明的源文件将在没有更改的情况下替换当前选项卡。  |
|    从独立窗口中调用的声明源文件在主 IDE 窗口中打开    |  当您从独立窗口导航到方法、类或变量时，CLion 将在主编辑器中打开包含声明的源文件。  |
|    在编辑器标签上双击可执行“隐藏所有工具窗口”或“恢复窗口”操作    |  启用此选项后，您可以双击编辑器标签以 [隐藏和恢复所有工具窗口](tool-windows.html#hide_all)。 或者，您可以通过按下 `Ctrl+Shift+F12` (Windows), `⌘ ⇧ F12` (macOS), `⌘ ⇧ F12` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ F12` (macOS System Shortcuts), `Ctrl+Shift+F12` (XWin), `Ctrl+Shift+F12` (GNOME), `Ctrl+Shift+F12` (KDE), `Ctrl+Shift+F12` (Emacs), `Ctrl+Shift+F12` (Sublime Text), `⌘ ⇧ F12` (Sublime Text (macOS)), `⌘ ⇧ F12` (Xcode), `Ctrl+Shift+F12` (Visual Studio), `⌘ ⇧ F12` (Visual Studio (macOS)), `Ctrl+Shift+F12` (ReSharper), `⌘ ⇧ F12` (ReSharper (macOS)), `Ctrl+Shift+F12` (QtCreator), `⌘ ⇧ F12` (QtCreator (macOS)), `Ctrl+Shift+F12` (NetBeans), `Ctrl+Shift+F12` (Eclipse), `⌘ ⇧ F12` (Eclipse (macOS))或从主菜单中选择  `窗口 \| 活动工具窗口 \| 隐藏所有窗口/还原窗口` 来完成此操作。  |
|    在编辑器选项卡上按两次点击以执行“最大化编辑器”/“恢复分割”操作    |     当此选项启用时，您可以双击 [split editor tab groups](null) 中的标签页，以更改标签组的相对大小：第一次双击会将该标签页及其组扩展到最大，并将所有其他组缩小到最小宽度/高度；第二次双击会为每个标签组分配相同的宽度和高度。       或者，您可以从主菜单中选择  `窗口 \| 编辑器标签 \| 最大化编辑器/恢复拆分` 或从 [查找操作](null)弹出窗口中选择这些操作 `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS))。       此选项可以与   在编辑器标签上双击可执行“隐藏所有工具窗口”或“恢复窗口”操作   一起使用，但请准备好每次双击文件标签时在 IDE 布局中进行多次更改。     |
|    在嵌套拆分中均衡比例    |  使用此选项以使编辑器中多个水平或垂直拆分的大小均匀。  |
|    将固定的标签页保留在左侧    |  始终将 [pinned tabs](null)移动到编辑器选项卡栏的左侧。 否则，不固定标签页的位置未定义，您可以根据需要在标签栏上移动它们。  |

## 环境文件

使用此部分为 [通过脚本初始化工具链环境](how-to-create-toolchain-in-clion.html#env-scripts) 配置额外选项。

|  项  |  描述  |
| --- | --- |

|    用于加载环境的回退 shell    |  在 Linux（本地或远程）、 [WSL](how-to-use-wsl-development-environment-in-product.html) 和 [Docker](clion-toolchains-in-docker.html) 上，CLion 在默认登录 shell 中调用  `source`  或  `.` ，登录 shell 由  `$SHELL`  变量设置。 如果  `$SHELL`  为空，CLion 使用此字段中指定的 shell。  |
|    读取环境文件的最大时间（毫秒）    |  限制 CLion 尝试加载指定环境文件的时间，超时后报告错误。  |
|    根据文件修改时间戳缓存环境文件中的环境    |  启用环境状态缓存  |

## 查找 / 替换

使用本节配置额外选项以便与 [在项目中查找和替换](finding-and-replacing-text-in-project.html) 一起使用。

|  项  |  描述  |
| --- | --- |
|    在“查找用法”视图中启用相似用法聚类    |     CLion 分析搜索结果，检测最常见的使用模式，并根据其结构相似性将所有找到的用法分类到不同的组中。 这些使用集群出现在   预览  选项卡中。       欲了解更多信息，请参阅 [在项目中搜索用法](find-highlight-usages.html#find-usages)。     |
|    “在文件中查找/显示用法”预览中显示结果的最大数量    |  默认的结果最大数量是  `100` 。 增加此限制可能会显著增加内存使用量。  |
|    显示“找到的结果过多”警告的上限    |  默认限制为  `1000` 个结果。  |

## GitHub

|  项  |  描述  |
| --- | --- |
|    GitHub 主机别名    |     为  `github.com`  设置别名。     |

## GitHub 操作

|  项  |  描述  |
| --- | --- |
|    GitHub Actions 编写支持(需要重启 IDE)    |     启用 [GitHub Actions 支持](github-actions.html)，以便自动执行构建、测试和部署流水线。     |

## IDE

使用此部分来配置存储您的项目中不同实体的额外选项。

|  项  |  描述  |
| --- | --- |
|    最近项目的最大数量    |  使用此选项更改默认存储的最近项目数量，这是  `50` 。  |
|    最近文件的最大数量    |  使用此选项更改默认存储的 [最近文件](recent-files-and-changes.html#recent_files)数量，默认为  `50` 。  |
|    最近位置的最大数量    |  使用此选项更改存储的默认数量的 [最近位置](recent-files-and-changes.html#recent_locations)，该数量为  `25` 。  |
|    在本地历史记录中存储更改的时长    |  使用此选项来指定您希望保留在 [本地历史记录](local-history.html)中更改的天数。  |

## JavaScript 和 TypeScript 

|  项  |  描述  |
| --- | --- |
|    语义高亮显示准确性    |     使用此字段配置高亮显示语义差异的详细程度。 可用选项有   高  、   正常  （默认）、   基本   和   有限  。       请注意，选择更高的精度级别可能导致更高的 CPU 用法，从而引发性能问题。     |
|    高级 JavaScript 注解器    |  选中此复选框后，CLion 会在 JavaScript 和 JSX 代码中执行更深入的 JavaScript 专用语义分析。  |
|    高亮显示 JSX 客户端组件    |  选中此复选框后，CLion 会对 JSX 服务器组件和 JSX 客户端组件应用不同高亮显示样式。  |
|    高级 JSX 注解器    |  选中此复选框后，可使 CLion 对 JSX 及 TSX 代码中的 JSX 标记进行更深入的语义分析。  |
|    在“在文件中查找”中选择“Directory”时，在库文件中搜索    |  选中此复选框后，搜索指定文件夹时会包含库文件。  |
|    对于当前导入图之外的文件，回退到 IDE 类型评估器    |  选中此复选框以禁止评估项目  `tsconfig.json` 文件确定的引入关系图之外文件的类型。  |

## Kubernetes

|  项  |  描述  |
| --- | --- |
|    如无可用集群，则显示空的 Kubernetes 节点    |  选中后，如果没有可用的集群，CLion 会在   服务   工具窗口中显示   Kubernetes   节点。  |
|    可加载的 kubeconfig 文件最大大小    |  指定 CLion 尝试加载的  `kubeconfig`  文件的最大大小（以 MB 为单位）。  |
|    可加载的 CRD YAML 文件最大大小    |  指定 CLion 尝试加载的资源 YAML 文件的最大大小（以 MB 为单位）。  |
|    kubectl 集群操作的超时时间    |  指定 CLion 等待  `kubectl`  集群操作完成的超时时间（以秒为单位）。 如果操作耗时较长，将因延迟或无响应而被取消。  |
|    HTTP 请求的超时时间    |  指定 CLion 等待发送到 Kubernetes 集群的 HTTP 请求完成的超时时间（以秒为单位）。 如果请求耗时较长，将因延迟或无响应而被取消。  |

## Markdown

|  项  |  描述  |
| --- | --- |
|    隐藏浮动工具栏    |  当您在 Markdown 文件中选择一些文本时，CLion 会显示一个 [浮动工具栏](markdown.html#floating-toolbar)，其中包含各种格式选项。 如果您不想看到浮动工具栏，请选择此复选框，然后重新打开选项卡以应用更改。  |
|    将页眉锚中的多个短横线合并    |  将章节标题中生成的锚点中的两个或更多破折号转换为一个。  |

## Makefile

使用此部分为 [Makefile](makefiles-support.html) 项目配置其他选项。

|  项  |  描述  |
| --- | --- |
|    隐式 Make 输出分析器选项    |     在此字段中，您可以编辑  Make  输出分析器标志。       例如，如果您移除  `--just-print`  选项，您的项目将以单次通过的方式进行分析和构建。 然而，这可能会导致性能问题。 此外，在这种情况下，命令输出和  Make  输出将混合，这可能会影响分析器的准确性。     |
|    将 Make 输出保存到日志文件...    |  选中此复选框以收集  Make  输出日志。  |

## 其他

|  项  |  描述  |
| --- | --- |
|    HTTP 客户端请求日志中的最大请求数    |     指定在  `http-requests-log.http` 中的请求历史里将保存多少已执行 HTTP 请求。       存储的请求数量超过指定限制时，最早的请求及其关联的响应文件会自动移除。     |

## 项目视图

请使用此部分配置额外选项以供在 [项目工具窗口](project-tool-window.html)中使用。

|  项  |  描述  |
| --- | --- |
|    按输入键时将焦点移动到编辑器    |  选中此选项后，您可以在 项目视图 中按 `Enter` (Windows), `⏎` (macOS), `⏎` (IntelliJ IDEA Classic (macOS)), `⏎` (macOS System Shortcuts), `Enter` (XWin), `Enter` (GNOME), `Enter` (KDE), `Enter` (Emacs), `Enter` (Sublime Text), `⏎` (Sublime Text (macOS)), `⏎` (Xcode), `Enter` (Visual Studio), `⏎` (Visual Studio (macOS)), `Enter` (ReSharper), `⏎` (ReSharper (macOS)), `Enter` (QtCreator), `⏎` (QtCreator (macOS)), `Enter` (NetBeans), `Enter` (Eclipse), `⏎` (Eclipse (macOS)) 切换焦点到编辑器。  |
|    收起节点时，同时收起其下已展开的所有节点    |  当选择此选项时，CLion 会折叠子节点以及父节点。  |
|    导航到库类时，不在项目树中选中该类    |     即使启用了   项目   选项，也不要自动导航到   始终选择已打开的文件   工具窗口中的库文件。       您可以在工具窗口中手动导航到库文件：使用   选择已打开的文件   ![](https://resources.jetbrains.com/help/img/idea/2026.3/app-client.expui.general.locate.svg)按钮，位于   项目  工具窗口工具栏，或按 `Alt+F1` (Windows), `⌥ F1` (macOS), `⌥ F1` (IntelliJ IDEA Classic (macOS)), `⌃ Q` (macOS System Shortcuts), `Alt+F1` (XWin), `Alt+Shift+1` (GNOME), `Alt+Shift+1` (KDE), `Alt+F1` (Emacs), `Alt+F1` (Sublime Text), `⌥ F1` (Sublime Text (macOS)), `⌘ ⇧ J` (Xcode), `Alt+F1` (Visual Studio), `⌥ F1` (Visual Studio (macOS)), `Alt+F1` (ReSharper), `⌥ F1` (ReSharper (macOS)), `Alt+F1` (QtCreator), `⌥ F1` (QtCreator (macOS)), `Ctrl+Shift+1` (NetBeans), `Alt+F1` (Eclipse), `⌘ ⌥ W` (Eclipse (macOS))来打开   选择于  弹出窗口。     |
|    在项目视图中增大字体大小    |  如果您想更改   项目   视图中的字体大小，请选择此选项。 您需要重新启动 CLion。  |
|    在项目视图中启用草稿和控制台    |     在 IDE 级别的   项目   工具窗口中显示或隐藏   临时文件与控制台   节点。       此节点包含您的 [临时文件](scratches.html) 和 [查询控制台](query-consoles.html)。       要按项目隐藏节点，请在 [工具窗口设置](project-tool-window.html#scratches_consoles) 中使用相应选项。     |

## Rails

|  项  |  描述  |
| --- | --- |
|    自动加载生成器    |  默认启用，使用此选项自动加载 Rails 生成器。 禁用此选项时，您仍然可以手动触发操作。  |

## Rake

|  项  |  描述  |
| --- | --- |
|    自动加载任务    |  默认启用，使用此选项自动加载 Rake 任务。 禁用此选项时，您仍然可以手动触发操作。  |

## Python

|  项  |  描述  |
| --- | --- |
|    在 Pytest 中交换实际和期望断言的顺序    |  默认情况下，CLion 提供  `expected == actual`  pytest 断言。 选中此复选框以更改断言参数的顺序为  `actual == expected` 。  |
|    Pytest：不添加 "--no-header --no-summary -q"    |  使用此复选框管理 pytest 生成的测试输出。 选中此选项以继续渲染标题和摘要。  |
|    Code Vision: 要搜索的最大用法数    |  限制在用法嵌入提示中为 Python 类、函数和方法统计的用法数量。  |
|    调试器: 附加到进程连接超时    |  指定在 [将调试器附加到该进程](attach-to-process.html)后，CLion 等待正在运行的进程连接的时长，以毫秒为单位。  |
|    使用 '# type: ignore' 禁止: 包含检查代码    |     选中此复选框，使   使用 'type: ignore' 注释禁止   快速修复在中括号中添加检查代码，例如  `# type: ignore[unresolved-references]` 。 清除此复选框后，快速修复会添加一个裸  `# type: ignore`  注释，从而抑制该行上的所有检查。       此选项默认已启用。     |
|    使用 '# type: ignore' 禁止: 将 'pycharm:' 命名空间添加到代码    |     选中此复选框，将  `pycharm:`  命名空间添加到   使用 'type: ignore' 注释禁止   快速修复插入的代码中，例如  `# type: ignore[pycharm:unresolved-references]` 。 有了该命名空间，其他类型检查器会忽略检查代码。       清除   使用 '# type: ignore' 禁止: 包含检查代码   复选框时，此选项无效。 默认情况下已禁用。     |
|    类型检查器: 使用严格联合语义    |     选中此复选框以严格检查联合类型：仅当联合类型的每个成员都与预期类型匹配时，联合类型的值才与该预期类型匹配。 例如，CLion 会报告将类型为  `int \| str`  的值传递给类型为  `int`  的参数。       此选项默认已启用。       禁用该选项时，只要有一个匹配的成员就足够，并且 CLion 不会报告只有联合中的部分成员支持的操作，例如调用  `x.upper()` ，此时  `x`  为  `int \| str` 。     |

## 运行/调试

|  项  |  描述  |
| --- | --- |
|    临时配置限制    |  使用此选项可以更改默认存储的临时 [run/debug configurations](run-debug-configuration.html)的数量，其默认值为  `5` 。  |
|    以进程终止确认重新运行    |  当您对一个正在运行的进程调用 rerun 时，CLion 会提示您确认终止现有进程并启动一个新进程的操作。 您可以通过取消选中此复选框来更改默认行为。  |
|    使配置默认固定    |  选择此选项可在您运行配置后自动固定在   运行   工具窗口中打开的选项卡。  |
|    自动为新的 CMake/Makefile 目标生成配置    |  当您添加新目标并重新加载 [CMake](quick-cmake-tutorial.html) 或 [Makefile](makefiles-support.html) 项目时，CLion 会自动创建相应的 [CMake 应用程序](run-debug-configuration-application.html) 或 [本机应用程序](run-debug-configuration-makefile-application.html) 配置。  |
|    自动删除缺失的 CMake/Makefile 目标的配置    |  当您删除目标并重新加载 [CMake](quick-cmake-tutorial.html) 或 [Makefile](makefiles-support.html) 项目时，CLion 会自动删除相应的 [CMake 应用程序](run-debug-configuration-application.html) 或 [本机应用程序](run-debug-configuration-makefile-application.html) 配置。  |
|    新界面中最近运行配置的最大数量    |     指定将在 [Run widget](new-ui.html#run-widget)中显示的最近运行/调试配置的数量。     |

## SSH

|  项  |  描述  |
| --- | --- |
|    配置文件解析器    |     请选择解析器：        * 遗留 ：使用 legacy parser 处理 `~/.ssh/config` 。    * OpenSSH ：使用基于 `ssh -G` 的解析器。 您的计算机上必须安装 OpenSSH。    |
|    OpenSSH 工具自定义路径    |  如果您已经选择了   OpenSSH   解析器，请指定 OpenSSH 的路径。  |
|    首选 SSH 会话后端    |     选择用于 SSH 连接的实现：        * 遗留 ：使用旧版 SSHJ 库。 这是默认选项。    * OpenSSH ：使用系统 OpenSSH 客户端。      如果某个后端出现连接问题，请尝试切换到另一个后端。     |

## STM32 微控制器

|  项  |  描述  |
| --- | --- |
|    使用 STM32 Cube CLI 扩展 CMake 的环境    |     选中此复选框后，CLion 会使用 Cube CLI 在项目中锁定的捆绑包扩展 CMake 配置文件的环境。 取消选中该复选框可关闭此集成。       有关更多信息，请参阅 [使用 Cube CLI 管理捆绑包](embedded-stm32.html#cube-cli)。     |

## Search Everywhere

|  项  |  描述  |
| --- | --- |
|    在“Search Everywhere”中显示文本搜索结果    |     在   Search Everywhere   中启用 [文本搜索](searching-everywhere.html#enable_text_search)。 结果将显示在新的   文本  选项卡上，并在列表底部的   全部  选项卡上显示。     |
|    等待所有贡献者完成后再显示结果    |     等待所有搜索贡献者完成任务后再显示最终搜索结果。 此选项可固定搜索结果中某项目的位置，防止其在列表中跳动。 如果存在速度较慢的搜索贡献者，此选项可能会减慢 "Search Everywhere" 的操作速度。       在   贡献者等待超时（毫秒）   字段中，指定等待搜索贡献者完成其任务的时间长度。     |
|    在搜索结果上方显示通知    |     此选项默认已启用。 提示等信息通知会作为不可选的灰色信息行显示在搜索结果中。 禁用此选项后，   Search Everywhere   窗口只显示实际搜索结果。     |
|    贡献者等待超时（毫秒）    |     搜索时，结果会从多个来源以不同速度返回。 为避免结果列表不断重排或闪烁，启用此选项后会短暂延迟显示结果，以便一并收集和展示。 此值指定结果显示前的最大延迟（默认 2,000 毫秒或 2 秒），即使某些慢的来源尚未完成。 如果主要来源足够快地返回足够的匹配项，结果会立即显示。 超时仅在主要来源较慢时生效。     |
|    在结果列表顶部显示最近的文件    |  启用此选项可优先显示最近文件中的结果，而非按与查询的匹配度排序。  |
|    在“随处搜索”操作标签中启用拼写错误容忍搜索支持。    |  搜索 IDE 操作（ `Ctrl+Shift+A` (Windows), `⌘ ⇧ A` (macOS), `⌘ ⇧ A` (IntelliJ IDEA Classic (macOS)), `⌘ ⇧ P` (macOS System Shortcuts), `Ctrl+Shift+A` (XWin), `Ctrl+Shift+A` (GNOME), `Ctrl+Shift+A` (KDE), `Escape, X` (Emacs), `Ctrl+Shift+P` (Sublime Text), `⌘ ⇧ P` (Sublime Text (macOS)), `⌘ ⇧ A` (Xcode), `Ctrl+Shift+A` (Visual Studio), `⌘ ⇧ A` (Visual Studio (macOS)), `Ctrl+Shift+A` (ReSharper), `⌘ ⇧ A` (ReSharper (macOS)), `Ctrl+Shift+A` (QtCreator), `⌘ ⇧ A` (QtCreator (macOS)), `Ctrl+I` (NetBeans), `Ctrl+Shift+A` (Eclipse), `⌘ 3` (Eclipse (macOS))）且拼错其名称时，IDE 也能识别并找到匹配操作。 例如，输入拼写错误的操作名称时会返回正确的操作结果，而不会显示为无结果。  |
|    基于机器学习对“操作”选项卡中的结果进行排序    |  默认情况下，   操作   选项卡上的搜索结果是使用机器学习进行排序的，而不是标准的排名机制。  |
|    基于机器学习对“文件”选项卡中的结果进行排序    |  默认情况下，   个文件   选项卡上的搜索结果是使用机器学习进行排序的，而不是标准的排名机制。  |
|    基于机器学习对“全部”选项卡中的结果进行排序    |  在   全部   选项卡上使用机器学习排序搜索结果，而不是标准排序机制。  |
|    在“操作”选项卡中启用语义搜索    |  请选择此选项，如果您希望 CLion 在   操作  选项卡中使用语义搜索（一种分析搜索查询背后的意图和上下文含义的技术）以提供更相关的结果。  |
|    在“文件”选项卡中启用语义搜索    |  请选择此选项，如果您希望 CLion 在   个文件  选项卡中使用语义搜索（一种分析搜索查询背后的意图和上下文含义的技术）以提供更相关的结果。  |
|    在“符号”选项卡中启用语义搜索    |  请选择此选项，如果您希望 CLion 在   符号  选项卡中使用语义搜索（一种分析搜索查询背后的意图和上下文含义的技术）以提供更相关的结果。  |
|    在“类”选项卡中启用语义搜索    |  请选择此选项，如果您希望 CLion 在   类  选项卡中使用语义搜索（一种分析搜索查询背后的意图和上下文含义的技术）以提供更相关的结果。  |

## 在查找、替换、重命名中搜索作用域

|  项  |  描述  |
| --- | --- |
|    保留最后选择的搜索范围    |  选择此选项可快速查看搜索作用域的历史记录。  |

## 安全分析

|  项  |  描述  |
| --- | --- |
|    显示“问题”标签页    |  使用此选项显示 Java 或 Kotlin 安全代码分析结果。  |

## 启动

|  项  |  描述  |
| --- | --- |
|    如果在项目首次启动时没有打开任何文件，打开 README.md 文件    |  如果您选择此选项，CLion 会在您启动项目时打开一个  `README.md`  文件，如果没有任何已打开的文件。  |

## 建议的重构

|  项  |  描述  |
| --- | --- |
|    在编辑器中显示建议的重构的提示    |  检测到重构时，在编辑器中显示行内提示。 禁用此选项后，尽管重构仍然可用，但不会显示提示。  |

## 终端

配置与使用 [embedded terminal emulator](terminal-emulator.html)相关的高级设置。

|  项  |  描述  |
| --- | --- |
|    显示应用程序标题    |  显示在终端中运行的应用程序设置的标题。  |
|    终端回滚缓冲区大小    |  使用此选项可增大终端中的缓冲区大小。  |
|    预输入    |  在终端中启用 typeahead，这在您预期打字延迟时对远程连接很有用。  |
|    预输入延迟阈值    |  当终端延迟超过指定值（以毫秒为单位）时，开启 typeahead。  |
|    为备用屏缓冲区使用 1.0 行间距    |     使用备用屏幕缓冲区的终端应用程序可能有其自己的视觉风格。 此设置在终端的备用屏幕缓冲模式下保持使用 1.0 行间距。     |
|    包括行间距在内填充字符背景    |     如果替代屏幕缓冲模式中的行间距值超过 1.0，行之间可能会出现白色的水平间隙。 选中此复选框以填写这些空白。     |
|    终端字符编码    |  指定终端的编码。  |
|    新终端输出容量    |  为 [重构终端](terminal-emulator.html#terminal-engine) 指定缓冲区大小。  |
|    按 Shift+Enter 发送 Esc+CR    |     选择此选项后，在按下  `Shift`   `Enter`  时，将向 shell 发送  `Esc`  + 回车，而不是常规回车。       默认情况下，终端对  `Enter`  和  `Shift`   `Enter`  发送相同的按键序列。 启用此选项后，按下  `Shift`   `Enter`  会在回车前多发送一个  `Esc`  字符。 这允许命令行应用程序区分并处理  `Shift`   `Enter` ，例如在输入多行命令时插入新行。     |
|    在部署目录中启动 SSH 终端    |     选择此选项可在部署目录中启动新的 SSH 会话。       如果禁用，SSH 会话将在默认远程目录（主目录或 SSH 配置中定义的路径）启动。     |

## 测试索引任务

|  项  |  描述  |
| --- | --- |

|    将测试索引显示为后台任务    |  您可以在进度条中像其他 [process](working-with-processes.html) 一样监控并暂停/取消测试索引。 此选项默认已启用。  |
|    在指定的超时时间（毫秒）后将测试索引显示为后台任务    |  此选项设置测试索引作为进程出现在进度条中的时间间隔。  |

## 工具窗口

|  项  |  描述  |
| --- | --- |
|    始终显示工具窗口页眉图标    |     默认情况下，工具窗口标题中的图标（例如， ![隐藏](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.hide.svg) 和 ![选项](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moreVertical.svg) ）仅在您将鼠标悬停在工具窗口上或工具窗口获得焦点时显示。       启用此选项可始终显示工具窗口标题图标。     |
|    允许通过页眉拖动工具窗口移动到其它位置    |     通过拖动标题移动工具窗口。       当此选项被禁用时，您可以通过拖动工具窗口条、使用   移动到   上下文菜单选项或位于 ![工具窗口选项菜单](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.settings.svg) / ![选项](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.moreVertical.svg) 图标下的工具窗口设置来 [移动工具窗口](manipulating-the-tool-windows.html#move-tool-windows)。     |

## 用户界面

|  项  |  描述  |
| --- | --- |
|    在 Windows/macOS 上使用原生文件选择对话框    |  在 Windows 和 macOS 上，IDE 将使用操作系统专有的文件选择对话框来打开文件和目录。  |
|    在 IDE 框架页眉显示文件类型图标    |  在 macOS 上，该图标可用于将文件拖动到其他应用程序。  |
|    在 macOS 上用单词而非符号表示键盘快捷键    |  如果您希望看到带有文字的快捷方式而不是符号，请选择此选项。  |
|    释放鼠标右键即可激活菜单项    |     启用此选项（默认）时，在项目上松开按钮将选中该项目，在其他区域松开将关闭菜单。 禁用后，此按住并释放操作无效——需以普通方式打开菜单并点击项目。      > **Note:** > 此选项仅支持 Linux 和 macOS。    |
|    列表和树中循环滚动    |  按下第一个元素时选择最后一个元素，反之亦然。  |
|    在对话框中将鼠标光标定位在默认按钮上    |  当选择此选项时，鼠标指针将置于对话框中的默认按钮上（通常是   确定  ）。  |
|    禁用按两次修饰键快捷键    |  您可以禁用使用双键的快捷键。 例如， `Shift` (Windows), `Shift` (macOS), `Shift` (IntelliJ IDEA Classic (macOS)), `Shift` (macOS System Shortcuts), `Shift` (XWin), `Shift` (GNOME), `Shift` (KDE), `Shift` (Emacs), `Shift` (Sublime Text), `Shift` (Sublime Text (macOS)), `Shift` (Xcode), `Shift` (Visual Studio), `Shift` (Visual Studio (macOS)), `Shift` (ReSharper), `Shift` (ReSharper (macOS)), `Shift` (QtCreator), `Shift` (QtCreator (macOS)), `Shift` (NetBeans), `Shift` (Eclipse), `Shift` (Eclipse (macOS)) 或 `Ctrl` (Windows), `Ctrl` (macOS), `Ctrl` (IntelliJ IDEA Classic (macOS)), `Ctrl` (macOS System Shortcuts), `Ctrl` (XWin), `Ctrl` (GNOME), `Ctrl` (KDE), `Ctrl` (Emacs), `Ctrl` (Sublime Text), `Ctrl` (Sublime Text (macOS)), `Ctrl` (Xcode), `Ctrl` (Visual Studio), `Ctrl` (Visual Studio (macOS)), `Ctrl` (ReSharper), `Ctrl` (ReSharper (macOS)), `Ctrl` (QtCreator), `Ctrl` (QtCreator (macOS)), `Ctrl` (NetBeans), `Ctrl` (Eclipse), `Ctrl` (Eclipse (macOS))。  |
|    在非模态对话框中显示设置    |     默认情况下，设置窗口为非模态，这意味着在窗口打开时仍可与 IDE 交互。       取消选中此选项后，设置窗口将变为模态，并阻止与 IDE 的交互，直到窗口关闭。     |
|    使用简化的启动画面    |     简化的启动画面为标准启动图像提供了一个替代选项，减少了对光敏感或有感官偏好的用户产生视觉刺激的因素，如明亮的颜色或复杂的图形。     |

## 版本控制

|  项  |  描述  |
| --- | --- |
|    以编辑器标签方式打开差异    |  选中此选项时，“差异查看器”将显示为编辑器选项卡。  |
|    一体化差异    |  选中此选项时，所有更改的文件将在一个连续的差异视图中显示。  |
|    在编辑器中打开文件时从 VCS 加载文件注解    |  选择此选项时，CLion 在您打开编辑器中的文件时加载注解。  |
|    高亮显示被忽略的文件    |  当选择此选项时，CLion 将显示来自 VCS 的忽略文件列表并在编辑器中显示它们的状态。  |
|    启用提交工具窗口    |  当您选择此选项时，CLion将在单独的工具窗口中显示   本地更改  和   搁置  标签。  |
|    切换提交控件    |  当选择此选项时，CLion 会在执行提交后隐藏提交面板和复选框，并允许您在   提交更改  对话框中切换它们。  |
|    在窗口模式或浮动模式下提交后自动关闭提交工具窗口    |  当   提交   工具窗口处于 [窗口或悬浮模式](viewing-modes.html) 时，此选项可用。 选择后，工具窗口将在提交更改后自动关闭。  |
|    选择所有有新提交用于推送的仓库    |  如果选择此选项，CLion 将默认选择所有要推送的提交。  |
|    强制推送时不显示警告    |  此选项适用于未受保护分支上的强制推送操作。 选中后，CLion 在强制推送前不会请求确认。  |
|    对 Git 和 Mercurial 使用模态提交界面    |  选择此选项可在单独的模态提交对话框中提交本地更改。  |

## 版本控制。 Git

|  项  |  描述  |
| --- | --- |
|    递归克隆项目中的子模块    |  选择此选项后，在从 Git 检出时，  `git clone --recurse-submodules`  被使用来克隆包含所有可用子模块的主存储库。  |
|    从 Git 读取时应用内容转换    |  当选择此选项时，CLion 将在从 Git 读取文件内容时对  `--filters`  或  `--textconv`  标志使用  `git cat-file`  命令。  |
|    使用安全强制推送    |  选择此选项时，CLion 在从 IDE 调用强制推送时使用  `--force-with-lease`  而不是仅使用  `--force` 。  |
|    检查传入和传出的提交    |  选中此选项时，CLion 会在 VCS 小部件的分支名称旁显示传入（蓝色箭头图标 ![传入提交指示器](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.vcs.changesUpdate%4012x12.svg)）或传出（绿色箭头图标 ![传出提交指示器](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.vcs.changesPush%4012x12.svg)）提交记录。  |
|    更新项目后自动打开"更新信息"标签页    |  执行 [更新](sync-with-a-remote-repository.html#update) 操作后，   更新信息   选项卡将在   Git   工具窗口 `Alt+9` (Windows), `⌘ 9` (macOS), `⌘ 9` (IntelliJ IDEA Classic (macOS)), `⌘ 9` (macOS System Shortcuts), `Alt+9` (XWin), `Alt+9` (GNOME), `Alt+9` (KDE), `Alt+9` (Emacs), `Alt+9` (Sublime Text), `⌘ 9` (Sublime Text (macOS)), `⌘ 2` (Xcode), `Alt+9` (Visual Studio), `⌘ 9` (Visual Studio (macOS)), `Alt+9` (ReSharper), `⌘ 9` (ReSharper (macOS)), `Alt+9` (QtCreator), `⌘ 9` (QtCreator (macOS)), `Alt+9` (NetBeans), `Alt+9` (Eclipse), `⌘ 9` (Eclipse (macOS)) 中打开。  |
|    不运行 Git 提交钩子    |  选择此选项以在提交操作期间自动禁用运行提交钩子。  |
|    分支名称清理符号    |  指定一个符号，将自动替换 Git 分支名称中的空格和其他受限字符（默认：  `-` ）。  |
|    在最近项目列表中显示分支名称    |  默认情况下，已签出的分支名称会显示在欢迎界面和主菜单的最近项目列表中。 您可以禁用此设置，或仅为   具有相同名称的项目   切换。  |
|    在"随处搜索"中显示 Git 标签页    |  选择此选项可将 Git 选项卡添加到 [全局搜索](searching-everywhere.html) 窗口。  |

## WSL 工具链

|  项  |  描述  |
| --- | --- |
|  在登录（-l）shell 中执行命令  |  启用此选项后，CLion 会在登录 shell 中执行 [WSL](how-to-use-wsl-development-environment-in-product.html) 命令。 当您需要从  `.bashrc`  或  `.profile`  等文件中获取环境变量时，这非常有用。  |

