# 使用 West 管理 Zephyr® RTOS 项目

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

在 CLion 中，您可以使用内置的 [West](https://docs.zephyrproject.org/latest/develop/west/index.html) 插件打开、构建和运行/调试 Zephyr 项目。 与 CLion 的 CMake 集成相比，West 集成提供了一种更简单的方式来设置和构建 Zephyr 项目。 尽管您仍然可以使用 CMake，但我们建议使用 CLion 的原生 West 集成。

本指南解释了如何构建、运行和调试 Zephyr 应用程序。

Procedure: 安装 Zephyr 和 Python 依赖项

1. 在您的系统上安装 [Zephyr、West 和 Python 依赖项](https://docs.zephyrproject.org/latest/develop/getting_started/index.html#get-zephyr-and-install-python-dependencies)。

2. 在您的系统上安装 [Zephyr SDK](https://docs.zephyrproject.org/latest/develop/getting_started/index.html#install-the-zephyr-sdk)。

Procedure: 打开您的 West 项目

1. 在欢迎屏幕上点击   打开   或从主菜单中选择  `文件 | 打开` 。

2. 选择包含  `CMakeLists.txt`  文件的 Zephyr 项目目录。

3. 通过  `设置 | 构建、执行、部署 | 嵌入式开发 | West`  打开您的项目设置。

> **Tip:**
> 当您第一次打开 Zephyr West 目录时，可能会在 West 工具窗口中看到以下 CMake 错误消息：
>
>
>
>
> ```
> BOARD is not being defined on the CMake command-line, in the environment or by the app. Fix...
>
> ```
>
>
>
> 这意味着您尚未在 West 项目设置中配置您的板。 点击   修复……  ，West 对话框将打开，显示您的项目设置。

![West 项目设置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_west_project_settings.png)

4. CLion 会在 West 对话框中自动填充  `工具链` 、  `West 可执行文件`  和  `构建目录`  字段的默认值。 如果需要，您可以更改它们。

5. 在相应的字段中选择您的板名称（如果尚未自动选择）。

6. 点击   确定  。 CLion 将加载项目并在  `West 工具`  工具窗口中显示结果：

![West 项目加载](https://resources.jetbrains.com/help/img/idea/2026.3/cl_west_project_load.png)

Procedure: 设置运行/调试配置

CLion 会检测项目构建目标并为其创建原生 West 配置。 要设置其他参数：

1. 从主工具栏中选择  `运行 / 调试配置 | 编辑配置…`  或从主菜单中选择  `运行 | 编辑配置…` 。  `West 运行/调试配置`  对话框将打开。

![West 运行/调试配置](https://resources.jetbrains.com/help/img/idea/2026.3/cl_west_run_debug_configuration.png)

2. 复制您在终端中运行  `west flash` 和  `west debug` 命令时使用的命令行参数。 将它们分别粘贴到  `烧录选项`  和  `调试选项`  字段中。 如果选择  `在 QEMU 模拟器上启动运行和调试`  选项，则  `烧录选项`  和  `调试选项`  字段将不可用。

3. 点击   确定  ，您的程序将准备好运行和调试。

Procedure: 运行和调试您的程序

要运行或调试您的程序，您可以使用配置小部件（点击 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.run.svg) 或 ![](https://resources.jetbrains.com/help/img/idea/2026.3/app.expui.run.debug.svg)）、  `运行`  菜单或程序入口点旁边的标记图标。

以下是调试 Zephyr 程序的示例：

![Zephyr West 调试](https://resources.jetbrains.com/help/img/idea/2026.3/cl_west_debug.png)

> **Note:**
> CLion 支持多线程 RTOS 调试，允许您分别查看每个线程。 为此：
>
> 1.  在  `设置 | 构建、执行、部署 | 嵌入式开发 | RTOS 集成`  中 [启用 RTOS 集成](rtos-debug.html#enable-rtos)。
>
> 2.  在您的  `prj.conf` 文件中 [设置](rtos-debug.html#tasks-view)  `CONFIG_THREAD_MONITOR` 和  `CONFIG_THREAD_NAME` 。

## 将现有的 CMake 项目转换为 West，反之亦然

如果您有一个现有的 Zephyr 项目并以 CMake 项目运行，您可以将其转换为 West 项目。 为此，在项目目录中右键点击  `CMakeLists.txt`  文件，然后从上下文菜单中选择  `转换为 West 项目` 。

![将 CMake 项目转换为 West](https://resources.jetbrains.com/help/img/idea/2026.3/调试配置](run-debug-configuration.html)

### 操作指南

[编辑器基础知识](using-code-editor.html) [文件结构](file-structure.html) [构建操作](build-actions.html) [运行应用程序](running-applications.html) [调试](debugging-code.html)

