# 工具链

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

> **TL;DR**
> `设置 | 构建、执行、部署 | 工具链`

对于 [CMake](quick-cmake-tutorial.html)、 [Makefile](makefiles-support.html) 和 [编译数据库](compilation-database.html) 项目，在 CLion 中，工具链是一组构建和运行应用程序所需的所有必要工具：CMake 可执行文件（CMake 项目）、构建工具、C/C++ 编译器、调试器二进制文件以及工作环境。

当您开始使用 CLion 时，已经有一个默认工具链可用。 尽管您可以在开发中使用它，但您可能还希望根据项目的需求调整工具集（例如，切换到另一个编译器）。

> **Tip:**
> 您可以为一个项目配置多个工具链，并在需要时在它们之间切换。

选择您正在使用的项目类型以了解更多信息：

## CMake 项目

CLion 使用配置的工具链来构建和运行您的 CMake 应用程序。 设置工具链后，您可以在 [CMake 配置文件](cmake-profile.html) 设置中选择它。

## Makefile 项目

CLion 在加载 Makefile 项目时使用选定的工具链。 工具链还为 [本机应用程序](makefiles-support.html#rd-configs) 配置提供调试器。

配置工具链后，您将能够在  `设置 | 构建、执行、部署 | Makefile`  中选择它。

请参阅 [Makefiles：调整项目设置](makefiles-support.html#makefile-settings)。

## 编译数据库项目

CLion 使用选定的工具链来解析编译数据库项目文件。

配置工具链后，您将能够在  `设置 | 构建、执行、部署 | 编译数据库`  中选择它。 请注意， [远程](remote-projects-support.html) 工具链不支持编译数据库项目。

请参阅 [编译数据库：检查工具链](compilation-database.html#compdb_toolchain)。

## 自定义构建目标和应用程序

选定的工具链为自定义运行/调试配置提供环境和调试器。 请参阅 [创建自定义构建目标](custom-build-targets.html#customtarget-compdb)。

Procedure: 创建工具链

1. 转到  `设置 | 构建、执行、部署 | 工具链`  并点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.general.add.svg) 以添加新工具链。

Windows:

观看此视频以了解 Windows 工具链选项的概述：

[Video](https://www.youtube.com/v/Vj06cfj6LyI)

选择一个预定义的工具链设置（ [MinGW](quick-tutorial-on-configuring-clion-on-windows.html#MinGW)、 [Cygwin](quick-tutorial-on-configuring-clion-on-windows.html#Cygwin)、 [Visual Studio](quick-tutorial-on-configuring-clion-on-windows.html#MSVC) 或 [WSL](quick-tutorial-on-configuring-clion-on-windows.html#WSL)）、 [远程主机](remote-projects-support.html#remote-toolchain)、 [Docker](clion-toolchains-in-docker.html)）或配置自定义工具链（ [系统](quick-tutorial-on-configuring-clion-on-windows.html#system)）：

![Windows 工具链选项](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolchain_options.png)

> **Tip:**
> * 有关在 Windows 上配置 CLion 的更多信息，请参阅我们的 [教程](quick-tutorial-on-configuring-clion-on-windows.html)。
>
> * 远程主机工具链的描述请参阅 [远程与本地源](remote-projects-support.html#remote-toolchain)。 如果您正在使用 Docker 容器，请参阅 [Docker 工具链](docker.html)。

macOS/Linux:

在 Linux 或 macOS 上，选择您的工具链类型：   系统   用于本地项目，   远程主机   或   Docker   用于 [远程开发](remote-projects-support.html)。

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

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

2. 要通过脚本初始化工具链环境，请点击   添加环境   并指定文件路径。 有关更多信息，请参阅 [下文](#env-scripts)。

3. 如果需要，请从捆绑的 CMake 切换到您选择的自定义   CMake   安装。

> **Note:**
> 请确保自定义安装版本为 3.15. 或更新版。

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

5. CLion 将尝试检测 C/C++ 编译器。

如果您更喜欢使用自定义编译器而不是检测到的编译器，请在   C 编译器   和   C++ 编译器   中提供路径。 请参阅 [切换编译器](how-to-switch-compilers-in-clion.html)。

> **Note:**
> 如果您使用的是 GNU ARM 工具链，请确保它已在您的系统  `PATH`  中存在（请参阅 [嵌入式开发：工具链和编译器](embedded-overview.html#toolchains)）。
>
>
>
> 对于 IAR 工具链，请按照 [IAR 工具链](iar-toolchain.html) 中的描述指定编译器。

6. 选择 [调试器](configuring-debugger-options.html)。

在 macOS 上，您可以在捆绑的 LLDB（版本 21.1.7},{）和自定义 GDB 之间切换。

在 Windows 上，选项包括捆绑的 GDB（版本 17.1）、自定义 GDB 和用于 [MSVC](quick-tutorial-on-configuring-clion-on-windows.html#MSVC) 的 LLDB（版本 9.0.0）。

请注意，目前不支持自定义 LLDB。

7. CLion 会验证您的选择，并在工具或包缺失时通知您。

8. 配置完成后，点击   确定   以保存。

## 通过脚本初始化工具链环境

与手动设置环境相比，您可以将 CLion 指向一个环境文件——一个为您的项目初始化环境的 shell 脚本。 例如，当您需要初始化编译器变量、添加自定义变量或修改  `PATH`  时，这会很有帮助。

支持以下环境文件：

* `bat` 文件 — Windows MinGW 和 MSVC 工具链。

* `ps1` 文件 — Windows MinGW、Cygwin 和 MSVC 工具链。

* `shell` 文件 — Windows Cygwin、本地 Linux／macOS、WSL、Docker 和远程工具链。 > **Tip:** > 参见 [设置备用 shell](#set-shell)。

大多数框架都包含环境脚本，您可以直接使用。 请参阅 [ESP-IDF on macOS](esp-idf.html#env-vars-macos) 的示例。 您还可以创建自己的脚本，例如，当您需要源多个环境文件时：请参阅 [ESP-IDF on Windows](esp-idf.html#env-vars-windows) 的示例。

> **Note:**
> * 工具链环境会影响使用该特定工具链执行的所有步骤，包括 CMake 生成、构建和二进制启动。
>
> * 对于除 [Docker](clion-toolchains-in-docker.html) 之外的所有工具链，环境加载仅发生一次：第一次在 [CMake profile](cmake-profile.html) 中使用工具链或加载 [Makefile](makefiles-support.html) 时。 对于 Docker，每次使用工具链时都会加载环境。
>
> * 当您对环境文件进行更改时，CLion 默认会自动重新加载它。 您可以通过取消选中 设置 | 高级设置 中的 根据文件修改时间戳缓存环境文件中的环境 选项来防止环境状态被自动缓存。 此外，请注意， [重置 CMake](cmake-cache.html#reset-cache) 会使环境文件缓存失效。

Procedure:

1. 在工具链设置中，点击   添加环境  ，然后点击   从文件  ：

![设置脚本以初始化环境](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolchain_env_script.png)

2. 在   环境文件   字段中，指定脚本的路径：

![通过脚本初始化环境](https://resources.jetbrains.com/help/img/idea/2026.3/cl_toolchain_env_script_file.png)

3. 如果脚本加载出现问题，您将收到通知。 CLion 还会检查脚本加载时间，并在执行时间过长时终止执行。

![环境脚本加载报告](https://resources.jetbrains.com/help/img/idea/2026.3/cl_env_script_error.png)

Procedure: 设置备用 shell

* 要在 Linux（本地或远程）、 [WSL](how-to-use-wsl-development-environment-in-product.html) 和 [Docker](clion-toolchains-in-docker.html) 上加载环境文件，CLion 会在默认登录 shell 中调用  `source`  或  `.` ，具体取决于  `$SHELL`  变量。

如果  `$SHELL`  为空，CLion 将使用   用于加载环境的回退 shell   字段中 [高级设置](advanced-settings.html) 指定的 shell。

## See also

### 流程

[快速 CMake 教程](quick-cmake-tutorial.html) [Makefile 项目](makefiles-support.html) [教程：在 Windows 上配置 CLion](quick-tutorial-on-configuring-clion-on-windows.html)

### 参考

[高级设置](advanced-settings.html)

