# 教程：在 macOS 上配置 CLion

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

本教程将指导您完成在 macOS 上安装、更新和初始配置 CLion 的过程。

## 安装步骤

在开始在 macOS 上安装 CLion 之前，请确保您的机器满足 [硬件要求](installation-guide.html#requirements-cl)，并且您的 macOS 版本为 10.9.4 或更高。

> **Note:**
> 您始终可以在同一操作系统上安装多个 CLion 实例，包括发布版本和 EAP 版本。

Procedure: 手动安装和补丁更新

1. 下载最新的 [正式版本](https://www.jetbrains.com/zh-cn/clion/download/#section=mac)或 [EAP 版本](https://www.jetbrains.com/zh-cn/clion/nextversion/)的 macOS 版 CLion（早期版本可在 [以前的 CLion 版本](https://www.jetbrains.com/zh-cn/clion/download/previous.html)页面找到）。

2. 打开下载的   CLion-*.dmg  包并将 CLion 拖动到   应用程序  文件夹。

3. 打开   应用程序  文件夹并启动 CLion 安装程序。

4. 如果出现安全警告，请同意打开应用程序：

![cl_macinstall_warning_dark.png](https://resources.jetbrains.com/help/img/idea/2026.3/cl_macinstall_warning.png)

5. 当您手动安装 CLion 时，默认情况下会自动执行更新检查（每次 IDE 准备更新时，您将在 [状态栏](null)中看到一条消息）。 要配置更新过程，请转到  `设置 | 外观和行为 | 系统设置 | 更新`  并选择更新通道：

![cl_updatechannel_choice_dark.png](https://resources.jetbrains.com/help/img/idea/2026.3/cl_updatechannel_choice.png)

点击   立即检查  立即执行检查。 如果根据所选通道有可用更新，您将看到如下对话框：

![cl_update_prompt_dark.png](https://resources.jetbrains.com/help/img/idea/2026.3/cl_update_prompt.png)

Procedure: 通过 Toolbox 安装和更新

Toolbox  是一个控制面板，允许您从一个访问点管理所有 JetBrains 开发工具（包括 CLion）以及您的项目。 它使您能够维护不同版本的 CLion，安装更新并在需要时回滚。 Toolbox 会记住您的 JetBrains 帐户，并在您安装和注册新工具时自动登录。

1. 下载 [Toolbox](https://www.jetbrains.com/zh-cn/toolbox/app/) 并启动安装文件。

2. 安装完成后，接受 JetBrains 隐私政策并登录您的 JetBrains 帐户。

3. 现在您可以选择要安装的 CLion 版本：

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

4. Toolbox   显示已安装版本的列表：

![cl_toolbox_installed_dark.png](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolbox_installed.png)

5. 在   设置   对话框中，配置 CLion 的更新方式：

![cl_toolbox_update_dark.png](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolbox_update.png)

请注意，如果使用   Toolbox  ，则无法从 IDE 内部配置更新过程。  `设置 | 外观和行为 | 系统设置 | 更新` 对话框显示以下消息：

![cl_toolbox_externalupdate_dark.png](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolbox_externalupdate.png)

> **Tip:**
> 或者，您可以通过 [Homebrew 包管理器](https://brew.sh/)安装 CLion：  `brew cask install clion` 。 但是，此选项是非官方的，因为 CLion 团队未参与其维护或支持。

安装或升级后，系统会提示您导入、继承或 [创建新设置](run-for-the-first-time.html)以供 IDE 使用。

## 必需工具

CLion 需要提供 C 和 C++ 编译器。 这些工具可能已预安装在您的系统中：在  `设置 | 构建、执行、部署 | 工具链` 中检查——编译器和  make 检测应成功执行。

如果您的系统没有可用的编译器安装，最简单的解决方案是安装   Xcode 命令行开发者工具  。

Procedure:

1. 请运行以下命令：

```CONSOLE
xcode-select --install
```

> **Note:**
> 或者，您可以单独安装编译器，然后在  `设置 | 构建、执行、部署 | 工具链` 中提供路径。

2. 当系统提示安装命令行开发工具时，点击   安装  按钮：

![cl_xcodetools.png](https://resources.jetbrains.com/help/img/idea/2026.3/cl_xcodetools.png)

您也可以选择安装完整的 Xcode 包，但这对 CLion 来说并非必要。

使用 Xcode 命令行工具，默认会安装 Clang 编译器。 要检查编译器的存在及其版本，请运行  `clang --version` 。

命令行工具可能不会随着系统或 Xcode 的更新而自动更新。 这可能会在 CLion 中加载项目时导致类似  invalid active developer path 的错误消息。 要解决此问题，请运行相同的  `xcode-select --install` 命令，工具将相应更新。

请注意，您可以根据项目需求使用多个编译器，请参阅 [编译器](how-to-switch-compilers-in-clion.html)。

## 配置工具链

现在，您需要配置 [工具链](how-to-create-toolchain-in-clion.html)以供使用，这意味着选择 CMake 可执行文件、构建工具、C/C++ 编译器和调试器。

导航到  `设置 | 构建、执行、部署 | 工具链` 并编辑默认工具链，或点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg)添加新工具链。

![macOS 工具链](https://resources.jetbrains.com/help/img/idea/2026.3/cl_macos_toolchains.png)

> **Tip:**
> 请参阅 [工具链](how-to-create-toolchain-in-clion.html) 以获取一般信息。
>
>
>
> 有关   远程主机  工具链的更多信息，请参阅 [本地源的远程](remote-projects-support.html#remote-toolchain)。 如果您使用的是 Docker 容器，请参阅 [Docker 工具链](docker.html)。

### CMake、构建工具和编译器

在   CMake   字段中，指定您要使用的 [CMake](https://cmake.org/) 二进制文件。 您可以使用捆绑的 CMake，或者使用自定义的 CMake 可执行文件（请参阅 [软件要求](installation-guide.html#requirements-cl)中的最低支持版本）。

默认情况下，CLion 将使用捆绑的 Ninja 作为   构建工具  。 您可以指定其他您选择的构建工具，例如  make 。

所选的 CMake 会尝试根据系统中安装的包检测编译器。 如果检测成功，   C 编译器  和   C++ 编译器  字段将自动填充：

![默认工具链](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolchain_detector.png)

> **Tip:**
> 当   CMake  无法定位适当的工具时，编译器检测会失败。 例如，如果您在没有 Xcode 开发工具的情况下单独安装了它们，就可能会发生这种情况。 在这种情况下，您需要手动提供实际路径。

### 调试器

macOS 版 CLion 附带捆绑的 LLDB v 21.1.7},{，这是默认调试器。 您也可以切换到自定义 GDB（支持的版本为 7.8.x-17.1）、自定义 LLDB 或 [DAP 调试器](dap-support.html)。

在  `设置 | 构建、执行、部署 | 工具链` 中选择调试器：

![macOS 的工具链调试器选项](https://resources.jetbrains.com/help/img/idea/2026.3/cl_debuggers_switch.png)

在 macOS 上使用 GDB 时可能会出现问题。 为了改善行为，请在注册表中启用   cidr.debugger.gdb.workaround.macOS.startupWithShell  选项（从主菜单中选择  `帮助 | 查找操作` 并输入  Registry ）：

> **Note:**
> GDB 和 Clang 的组合在 macOS 上调试项目时会有一定的限制。 有关更多信息和解决方法，请参阅 [macOS 上 GDB 的 STL 渲染器](configuring-debugger-options.html#gdb-config)。

![启用 cidr.debugger.gdb.workaround.macOS.startupWithShell 注册表项](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置](run-debug-configuration.html)