# 安装 CLion

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

CLion 是一个跨平台的 IDE，在 Windows、macOS 和 Linux 上提供一致的体验。 (有关在 FreeBSD 上设置的信息，请参阅 [此说明](https://intellij-support.jetbrains.com/hc/en-us/articles/206525024-How-to-start-CLion-on-FreeBSD-))

## 工具链要求

需要同时安装工具链和 CLion 本身，以便 IDE 准备就绪。 工具链是一组用于构建 C 和 C++ 应用程序的编程工具。 它通常包括编译器、调试器和构建系统。

Windows:

CLion 在 Windows 上捆绑了  MinGW  工具链，无需额外设置即可提供可直接使用的开发环境。 也可以手动配置其他工具链。 有关详细说明，请参阅 [在 Windows 上配置 CLion](quick-tutorial-on-configuring-clion-on-windows.html)。

有关 WSL 配置，请参阅 [配置 WSL 工具链](how-to-use-wsl-development-environment-in-product.html#wsl-tooclhain)。

macOS:

如果已安装 Xcode，则无需安装任何其他工具 – CLion 将检测预安装的工具。 如果没有 Xcode，安装 Xcode 命令行开发者工具即可。 可以通过在终端中运行  `xcode-select --install`  来安装它们。

有关详细说明，请参阅 [在 macOS 上配置 CLion](quick-tutorial-on-configuring-clion-on-macos.html)。

Linux:

在 Linux 上，使用 [GCC/G++](https://gcc.gnu.org/) 或 [Clang](https://clang.llvm.org/)。

```BASH
# Installing GCC:
sudo apt update
sudo apt install gcc
sudo apt install build-essential

# Installing Clang:
sudo apt update
sudo apt install clang

```

## 使用 Toolbox App 安装

[JetBrains Toolbox App](https://www.jetbrains.com/zh-cn/toolbox/app/) 是安装 JetBrains 产品的推荐工具。 用于安装和管理不同的产品或同一产品的多个版本，包括 [抢先体验计划](https://www.jetbrains.com/zh-cn/community/eap/)（EAP）和夜间版，需要时可更新和回滚，还可以移除任何工具。 Toolbox App 保持了一个项目列表，可以快速在正确的 IDE 和版本中打开任何项目。

> **Note:**
> 在使用 Toolbox App 之前，请确保其 [系统要求](https://www.jetbrains.com/zh-cn/help/toolbox-app/installation.html)已满足。

Windows:

Procedure: 安装 Toolbox App

1. 从 [Toolbox App 网页](https://www.jetbrains.com/zh-cn/toolbox/app/) 下载  `.exe`  安装程序。

2. 运行安装程序并按照向导步骤操作。

3. 运行 Toolbox App 后，点击通知区域中的图标 ![Toolbox App 图标](https://resources.jetbrains.com/help/img/idea/2026.3/app.nodes.toolbox.svg)并选择您要安装的产品。

要安装特定版本，请点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg) 并选择   可用版本  。

![Toolbox App 中的 CLion](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolbox_app.png)

从 Toolbox App 登录 JetBrains Account，它会自动激活所安装的任何 IDE 的可用许可证。

macOS:

Procedure: 安装 Toolbox App

1. 从 [Toolbox App 网页](https://www.jetbrains.com/zh-cn/toolbox/app/)下载磁盘镜像  `.dmg` 。

> **Note:**
> Intel 和 Apple Silicon 处理器有单独的磁盘映像。

2. 挂载映像，并将   JetBrains Toolbox   应用拖到  `应用程序`  文件夹。

3. 运行 Toolbox App 后，点击主菜单中的图标并选择要安装的产品。

要安装特定版本，请点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg) 并选择   可用版本  。

![Toolbox App 中的 CLion](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolbox_app_mac.png)

从 Toolbox App 登录 JetBrains Account，它会自动激活所安装的任何 IDE 的可用许可证。

Linux:

Procedure: 安装 Toolbox App

必须包含以下软件包：

`libxi6`   `libxrender1`   `libxtst6`   `mesa-utils`   `libfontconfig`   `libgtk-3-bin`   `tar`   `dbus-user-session` ，  `libxcb-keysyms1` 。

1. [下载 tarball](https://www.jetbrains.com/zh-cn/toolbox/app/)  `.tar.gz` 。

2. 将已下载的 Toolbox 应用分发包解压到您要安装应用程序的位置(  `<installation-directory>` )：

```SHELL
tar -xvf jetbrains-toolbox-<version>.tar.gz -C <installation-directory>

```

3. 要启动应用程序，请打开控制台，导航到 [安装目录](directories-used-by-the-ide-to-store-settings-caches-plugins-and-logs.html)(  `cd`  到  `<installation-directory>` )，然后运行以下命令：

```BASH
./bin/jetbrains-toolbox
```

这会在应用程序目录中初始化各种 Toolbox 应用程序文件：

```BASH
~/.local/share/JetBrains/Toolbox
```

首次启动时，Toolbox 应用还会在  `~/.local/share/applications`  中创建一个  `.desktop`  条目文件。

4. 选择要安装的产品。

要安装特定版本，请点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.actions.more.svg) 并选择   可用版本  。

![Toolbox App 中的 CLion](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolbox_app.png)

从 Toolbox App 登录 JetBrains Account，它会自动激活所安装的任何 IDE 的可用许可证。

> **Note:**
> 如果您通过 [Toolbox App](https://www.jetbrains.com/zh-cn/toolbox/app/)安装了 CLion，您可以在该应用中找到安装目录：打开 Toolbox App 中 IDE 实例的设置，展开   配置  ，然后查找   安装位置  字段。

## 独立安装

您可以手动安装 CLion，并可以选择管理每个实例及所有配置文件的位置。 例如，如果您有要求特定安装位置的策略，这将非常有用。

Windows:

Procedure:

1. [下载安装程序](http://www.jetbrains.com/clion/download/)  `.exe` 。

> **Note:**
> 对于 ARM64 处理器，有一个单独的安装程序。

2. 运行安装程序并按照向导步骤操作。

在   安装选项  步骤中，您可以配置以下内容：

* 创建用于启动 CLion 的桌面快捷键。

* 将带有 CLion [命令行启动器](working-with-the-ide-features-from-command-line.html)的目录添加到 `PATH` 环境变量，以便可以在命令提示符的任何工作目录中运行它们。

* 将 将文件夹打开为项目 操作添加到系统上下文菜单中（当您右键点击文件夹时）。

* 将特定文件扩展名与 CLion 关联，以便双击打开它们。

要运行 CLion，请在 Windows   启动   菜单中找到它，或使用桌面快捷键。 也可以在安装目录下的  `bin`  目录中运行启动器批处理脚本或可执行文件。

Windows (ZIP):

Procedure:

1. [下载 ZIP 压缩文件](https://www.jetbrains.com/zh-cn/clion/download/)

2. 将压缩包解压到所需文件夹。

要运行 CLion，请使用解压目录下的启动批处理脚本或可执行文件  `bin` 。

macOS:

Procedure:

1. [下载磁盘映像](https://www.jetbrains.com/zh-cn/clion/download/)。

> **Note:**
> Intel 和 Apple Silicon 处理器有单独的磁盘映像。

2. 挂载映像，并将   %instance%   应用拖到  `应用程序`  文件夹。

从  `应用程序`  目录、Launchpad 或 Spotlight 运行 CLion 应用。

Linux:

Procedure:

1. [下载 tarball](https://www.jetbrains.com/zh-cn/clion/download/)  `.tar.gz` 。

2. 解压缩下载的  `CLion-*.tar.gz`  归档文件。 推荐的解压目录是  `/opt` ：

```SHELL
sudo tar xvzf CLion-*.tar.gz -C /opt/

```

> **Warning:**
> 请勿在现有安装上解压 tarball 以避免冲突。 始终解压到一个干净的目录。

3. 从  `bin`  子目录执行  `CLion.sh`  以运行 CLion：

```SHELL
sh /opt/clion-*/bin/clion.sh

```

要创建桌面条目，请执行以下操作之一：

* 在欢迎屏幕上，点击 配置 | 创建桌面条目

* 在主菜单中，进入 工具 | 创建桌面条目

当您第一次运行 CLion 时，您可以采取几个步骤来完成安装，自定义您的实例，并开始使用该 IDE。

欲了解更多信息，请参阅 [首次运行 CLion](run-for-the-first-time.html)。

## 在 Linux 上安装为 snap 软件包

> **Warning:**
> CLion 通过 snap 安装可能会遇到一些问题，包括性能下降、使用 Chromium 进行 JavaScript 调试的问题 ( [WEB-38511](https://youtrack.jetbrains.com/issue/WEB-38511))、导入 SBT 项目的困难 ( [SCL-17169](https://youtrack.jetbrains.com/issue/SCL-17169/Snap-Flatpack-IntelliJ-fails-to-import-sbt-project)) 以及文件管理操作的延迟 ( [IJPL-1234](https://youtrack.jetbrains.com/issue/IJPL-1234/Show-in-dolphin-takes-a-long-time))。
>
>
>
> 如果您遇到这些问题，我们建议通过 [Toolbox App](#toolbox)安装 CLion，以获得更流畅的体验。

您可以将 CLion 安装为一个独立的 [snap](https://snapcraft.io) 包。 由于 snaps 自动更新，您的 CLion 安装将始终保持最新。

要使用 snaps，请按照  snapd 安装指南  中的说明安装并运行 [snapd](https://docs.snapcraft.io/core/install) 服务。

在 Ubuntu 16.04 LTS 及更高版本中，此服务已预安装。

CLion 通过两个渠道分发：

* 稳定 通道仅包含稳定版本。 要安装最新的 CLion 稳定版本，请运行以下命令： ```SHELL sudo snap install clion --classic ``` CLion snap 需要像传统打包的应用程序一样，完全访问系统，因此需要 `--classic` 选项。

* edge 渠道包含 EAP 版本。 要安装最新的 CLion EAP 版本，请运行以下命令： ```SHELL sudo snap install clion --classic --edge ```

安装 snap 后，可以通过运行  `clion`  命令来启动它。

要列出所有已安装的 snaps，请运行  `sudo snap list` 。

Procedure: 安装指定版本

1. 要检查可用版本的列表，请运行以下命令：

```SHELL
snap info clion

```

2. 您想要安装的版本，请运行以下命令：

```SHELL
sudo snap install clion --channel=<version>/stable --classic

```

有关其他 snap 命令的更多信息，请参阅 [Snapcraft 文档](https://docs.snapcraft.io/)。

## 在 Windows 上静默安装

静默安装在没有任何用户界面的情况下进行。 它可供网络管理员在多台机器上安装 CLion，并避免打断其他用户。

> **Tip:**
> 在执行静默安装或管理多台计算机上的 CLion 安装时，可以设置  `JETBRAINS_LICENSE_SERVER`  环境变量，使其指向 [浮动许可证服务器](https://www.jetbrains.com/zh-cn/help/license_server/Activating_license.html) 或 [License Vault](https://www.jetbrains.com/zh-cn/help/license-vault-cloud/Activating_a_license.html#to-activate-a-license) 的 URL。
>
>
>
> 或者，您可以通过添加  `-DJETBRAINS_LICENSE_SERVER`  [JVM 选项](tuning-the-ide.html#configure-jvm-options)来设置 Floating License Server 或 License Vault 的 URL。

要执行静默安装，请使用以下开关运行安装程序：

* `/S` ：启用静默安装

* `/CONFIG` ：指定路径到 [静默配置文件](#silent-config-cl)

* `/D` ：指定安装目录的路径 此参数必须在命令行中位于最后，即使路径包含空格，也不应包含任何引号。

* `/NCRC` ：禁用 [CRC 检查](https://nsis.sourceforge.io/Docs/Chapter4.html#acrccheck)，如果要禁止显示 验证安装程序 弹出窗口。

例如：

```PLAINTEXT
clion.exe /S /CONFIG=d:\temp\silent.config /D=d:\IDE\CLion

```

在安装过程中检查问题时，请在  `/LOG` 开关中添加日志文件路径和名称，并将其置于  `/S` 和  `/D` 参数之间。 安装程序将生成指定的日志文件。 例如：

```SHELL
clion.exe /S /CONFIG=d:\temp\silent.config /LOG=d:\JetBrains\CLion\install.log /D=d:\IDE\CLion
```

### 静默配置文件

可以在 [https://download.jetbrains.com/cpp/silent.config](https://download.jetbrains.com/cpp/silent.config) 下载 CLion 的默认静默配置文件。

静默配置文件定义了安装CLion的选项。 默认选项下，静默安装仅为当前用户执行：  `mode=user` 。 如果您想为所有用户安装 CLion，请将安装模式选项的值更改为  `mode=admin` ，并以管理员身份运行安装程序。

默认静默配置文件对于每个 JetBrains 产品都是独一无二的。 您可以根据需要修改它，以启用或禁用各种安装选项。

> **Note:**
> 可以在没有配置文件的情况下执行静默安装。 在这种情况下，请省略  `/CONFIG`  开关，并以管理员身份运行安装程序。 没有静默配置文件，安装程序将忽略所有其他选项：不会创建桌面快捷方式、添加关联，或更新  `PATH` 变量。 然而，它仍会在  开始  菜单的  JetBrains  下创建一个快捷方式。

## 系统要求

### 硬件

|  处理器  |  CPU，采用 x86_64 或 arm64 架构，4 核  |
|  内存  |  总内存 8 GB；IDE 进程可用 3 GB  |
|  磁盘空间  |  10 GB  |
|  显示分辨率  |  1280 x 720  |

### 操作系统

|  Windows  |  10、11  |
|  macOS  |  26、27  |
|  Linux  |     发行版：        * Ubuntu 24.04、26.04 LTS    * Fedora 44、45    * Debian 13    * Amazon Linux 2023      桌面环境：        * Gnome    * KDE Plasma      [glibc](https://ftp.gnu.org/gnu/libc/)：        * 2.28 或更高版本*     > **Tip:** > 不支持基于 BSD 的操作系统。    |

*   CLion 不适用于某些 Linux 发行版，例如 RHEL6/CentOS7，这些发行版不包含 JBR 21 所需的 [glibc](https://www.gnu.org/software/libc/) 2.29 版本。

### 远程开发

详细了解 [JetBrains 远程开发](remote.html)。

|  硬件  |     与 [桌面安装](#hardware-requirements) 相同。       需要本地磁盘或网络块存储(例如 EBS)。      > **Tip:** > 不支持网络文件系统，例如 NFS 和 SMB。    |
|  OpenSSH 服务器  |  版本 7.9p1 或更高版本  |
|     Docker       (如果 IDE 在容器中运行)     |  25.0、29.0  |
|  连接  |     服务器:        * 互联网下行容量至少为 50 Mbps      客户端-服务器连接：        * 最低 20 Mbps 带宽    * 最大延迟 200 ms    |
|  WSL  |     带有 [受支持的 Linux 发行版](#linux) 的 WSL 2。      > **Tip:** > 不支持 WSLg 图形转发。    |

无需安装 Java 即可运行 CLion，因为 JetBrains Runtime 已捆绑在 IDE 中(基于  JBR  21)。

> **Warning:**
> * 不支持使用已修改 JRE/JDK 的 CLion 配置。
>
> * 不支持手动移除或更改了发行文件(例如插件文件)的 CLion 安装。