# 高级配置

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

除了一些在 IDE 设置中可用的标准选项，CLion 还使您能够执行底层平台和 Java 运行时的低级别配置。

> **Warning:**
> 这种低级配置可能会导致意想不到的问题，并使您的 CLion 安装无法运行，如果您不确定您在做什么。 请联系 [JetBrains 支持团队](https://intellij-support.jetbrains.com/hc/en-us)，获取有关可能帮助解决当前问题的选项和值的说明。

## JVM 选项

CLion 运行在 Java Virtual Machine (JVM) 上，它有各种选项来控制其性能。

用于运行 CLion 的默认选项在 IDE [安装目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)中指定：

Windows:

`<IDE_HOME>\bin\clion64.exe.vmoptions`

macOS:

`CLion.app/Contents/bin/clion.vmoptions`

Linux:

`<IDE_HOME>/bin/clion64.vmoptions`

> **Warning:**
> 不要更改默认文件中的 JVM 选项，因为在 CLion 更新时会被替换。 此外，在 macOS 中，编辑此文件会破坏应用程序签名。

Procedure: 配置 JVM 选项

要执行以下操作之一，以在将重写原始文件的 [配置目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory) 中创建一个包含 JVM 选项的默认文件副本：

* 在主菜单中，进入  `帮助 | 编辑自定义 VM 选项` .

* 如果您没有任何项目处于打开状态，请在欢迎屏幕上点击   配置  ，然后点击   编辑自定义 VM 选项  。

* 如果您不能启动 CLion，请手动将包含 JVM 选项的默认文件复制到 CLion [配置目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory)。

如果您没有 CLion 配置目录的写入权限，您可以添加  `CLION_VM_OPTIONS` （在 Windows 上为  `CLION64_VM_OPTIONS` ）环境变量，以指定包含您首选 JVM 选项的文件位置。 此文件将覆盖默认文件和位于 CLion 配置目录中的副本。

> **Note:**
> 如果您使用 Toolbox App，它会管理安装和配置目录，并让您为每个 IDE 实例配置 JVM 选项。 打开 Toolbox App，点击 ![螺母图标](https://resources.jetbrains.com/help/img/idea/2026.3/toolbox_settings_screw_icon.png) 下拉图标，然后选择   设置  。

Procedure: 查找 JVM 选项文件

如果您不确定 CLion 从哪里获取其 JVM 选项，请检查以下内容：

1. 由  `CLION_VM_OPTIONS` （在 Windows 上为  `CLION64_VM_OPTIONS` ）环境变量指定的位置。 如果指定的文件存在，它将重写所有其他 JVM 选项文件。

2. 如果 Toolbox App 管理您的当前 CLion 实例，请打开 Toolbox App，点击 ![螺母图标](https://resources.jetbrains.com/help/img/idea/2026.3/toolbox_settings_screw_icon.png) 旁边的相关 IDE 实例，然后选择   设置  。 在   配置  下，找到   Java 虚拟机选项  并点击   编辑  。

3. 如果您正在运行独立的 CLion 实例，请检查 [配置目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory)。

4. 如果在先前的位置中没有定义 JVM 选项文件，CLion 将使用 [默认 JVM 选项文件](#default-jvm-options)。 不要修改它。 仅用于检查 CLion 使用的默认选项。

### 常用选项

大多数情况下，JVM 选项的默认值应是最佳的。 以下是最常被修改的：

`-Xmx`
: 限制 JVM 可为运行 CLion 分配的最大内存堆大小。 默认值取决于平台。 如果您遇到速度变慢的问题，您可能需要增加此值，例如，将此值设置为 2048 兆字节，将此选项更改为  `-Xmx2048m` 。
:
:
:
: 欲了解更多信息，请参阅 [增加 IDE 的内存堆](increasing-memory-heap.html)。

`-Xms`
: 指定 JVM 在运行 CLion 时分配的初始内存。 默认值取决于平台。 通常设置为允许最大内存（请参见 [-Xmx](#xmx)）的一半，例如，  `-Xms1024m` 。

`-XX:NewRatio`
: 指定堆中年轻代与老年代大小之间的比例。 在大多数情况下，推荐的比例是 2 到 4。 这会相应地将年轻生成的大小设置为老生成的 1/2 到 1/4，适合经常处理一个项目且每次只处理少数文件的情况。 但是，如果经常打开新文件并在多个项目之间切换，可能需要增大年轻生成。 在这种情况下，请尝试设置  `-XX:NewRatio=1` ，这将使年轻代与老年代一样大，从而允许对象在年轻代中停留更长时间。
:
:
:
: 如需更多信息，请参见 [Java Garbage Collection Basics](https://www.oracle.com/webfolder/technetwork/tutorials/obe/java/gc01/index.html)。

请将每个选项单独列在一行。 JVM 选项文件示例：

```PLAINTEXT
-Xmx4G
-Xms2G
-XX:NewRatio=4

```

有关可用 JVM 选项的更多信息，请参阅 [java](https://docs.oracle.com/en/java/javase/11/tools/java.html) 命令参考。

## 平台属性

CLion 使您可以自定义各种特定平台的属性，例如用户安装插件的路径和支持的最大文件大小。 用于运行 CLion 的默认属性在 IDE [安装目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)中指定：

Windows:

`<IDE_HOME>\bin\idea.properties`

macOS:

`CLion.app/Contents/bin/idea.properties`

Linux:

`<IDE_HOME>/bin/idea.properties`

> **Warning:**
> 不要更改默认文件中的平台属性，因为当 CLion 更新时，它会被替换。 此外，在 macOS 中，编辑此文件会破坏应用程序签名。

Procedure: 配置平台属性：

要在 [配置目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory) 中创建一个空的  `idea.properties`  文件，以覆盖原始文件中的值，请执行以下操作之一：

* 转到  `帮助 | 编辑自定义属性` 。

* 如果您当前没有打开任何项目，请在欢迎屏幕上点击   配置  ，然后选择   编辑自定义属性  。

* 如果您无法启动 CLion，请在 CLion [配置目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#config-directory) 中手动创建一个空的  `idea.properties`  文件。

如果您没有 CLion 配置目录的写入权限，您可以添加  `CLION_PROPERTIES`  环境变量来指定  `idea.properties`  文件的位置。 此文件中的属性将覆盖原始默认文件和 CLion 配置目录中的相应属性。

### 常用属性

用户经常更改 [默认 IDE 目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)的位置。 如需了解更多信息，请参阅 [更改 IDE 目录的位置](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html#change-ide-dirs)。

可能影响性能的限制：

`idea.max.content.load.filesize`
: CLion 能够打开的文件最大尺寸（以千字节为单位）。 处理大文件可能会影响编辑器性能并增加内存消耗。 默认值为  `20000` 。

`idea.max.intellisense.filesize`
: CLion 提供编码辅助的文件最大尺寸（单位：千字节）。 大文件的编码辅助可能会影响编辑器性能并增加内存消耗。 默认值为  `2500` 。

`idea.cycle.buffer`
: 控制台循环缓冲区的最大大小（以千字节为单位）。 如果控制台输出大小超过此值，最旧的行将被删除。 要禁用循环缓冲区，请设置  `idea.cycle.buffer.size=disabled` 。

`idea.max.vcs.loaded.size.kb`
: CLion 在 [比较更改](comparing-files-and-folders.html) 时，显示过去文件内容的最大大小（以千字节为单位）。 默认值为  `20480` 。

请在单独的行中指定每个属性。 示例平台属性文件：

```PLAINTEXT
idea.max.intellisense.filesize=5000
idea.cycle.buffer.size=1024

```

CLion 提供许多其他属性来定义与环境（窗口管理器、启动器、文件系统等）的交互。 大多数情况下，它们就像隐藏设置（即它们并未明显显示出来），您在某些情况下可能需要启用或禁用。 仅在获得 [JetBrains 支持团队](https://intellij-support.jetbrains.com/hc/en-us)建议时更改这些属性。

## 调整 CPU 核心数量

可以调整 IDE 在运行活动任务（例如索引页眉文件、更新符号等）时要使用的 CPU 核心数量，以便在 CLion 与计算机上运行的其他应用程序之间适当平衡性能。

Procedure: 设置 CPU 核心数量：

1. 请按 `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)) 或从主菜单中选择  `帮助 | 查找操作` 。 在打开的弹出窗口中，开始输入  `Registry` ，选择相应的项目并按 `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))。

![在“查找操作”中搜索注册表](https://resources.jetbrains.com/help/img/idea/2026.3/cl_findaction_registry.png)

2. 在此对话框中，开始键入  `cidr.indexer.thread.count` 。 IDE 会突出显示相应的键。

![注册表对话框](https://resources.jetbrains.com/help/img/idea/2026.3/cl_registryCPUCore.png)

点击高亮显示的字符串的   Value   字段，并输入所需的 CPU 核心数量，假定如下：

* 负值 N 表示实际的 CPU 核心数量将减少 N ，以确定将使用的核心数量。 例如，在 8 个 CPU 核心的情况下，设置 -1 以使用 7 个核心。

* 设置 0 以使用所有可用核心。

* 正值直接确定要使用的核心数量。

