vscode插件

vscode插件 - RT-Thread项目助手 | 跨平台开发 110.00

发布于 2025-01-02 21:46:17 浏览：2573 订阅该版

[tocm]

# RT-Thread项目助手

[![License: Apache 2.0](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](https://www.apache.org/licenses/LICENSE-2.0) [![Version](https://img.shields.io/visual-studio-marketplace/v/jswyll.jswyll-vscode-rtthread?color=blue)](https://marketplace.visualstudio.com/items?itemName=jswyll.jswyll-vscode-rtthread)

> 本扩展适用于使用RT-Thread Studio新建或导入的项目（或使用`scons --dist-ide --target=eclipse`生成然后使用RT-Thread Studio导入的），也适用于支持scons构建的RT-Thread项目，可生成vscode的代码浏览、编辑、编译、下载、调试的配置文件。
>
> 作者：jswyll，海南大学在读研究生一枚，主攻嵌入式RTOS应用与物联网全栈开发。

## 更新日志

### 2025-03-13 - v0.3.0

- 新增 冷启动运行Env命令与可视化菜单配置操作支持Linux与MacOS平台。

- 新增 生成RT-Thread Env配置时，如果没有`.vscode/c_cpp_properties.json`文件则自动调用`scons --target=vsc`生成。

- 优化 保存问题匹配器到设置文件，允许配置完成后脱离（禁用）此扩展。

- 优化 降低Env Windows中git.exe的优先级。

- 优化 细化右键菜单显示条件。

- 优化 切换工作区文件夹时自动关闭已打开的终端。

- 优化 当扩展的主要版本或特性版本更新时，弹出更新日志。

- 调整 生成配置时，默认的Env根路径（从`c:/env-windows`）改为`${userHome}/.env`。

- 修复 设置项“项目类型”的作用域应为工作区文件夹。

- 修复 从状态栏按钮打开终端时，工作路径应为选择的工作区文件夹。

- 移除 选择调试服务器为Segger Jlink时生成hex文件 **（破坏性变更，请安装Segger Jlink至V7.90以上以支持加载`.elf`文件）**。

### 2025-01-16 - v0.2.0

- 新增 支持Env Windows（v1.x和v2.x）：

- 支持菜单配置面板；

- 支持scons方式编译；

- 支持在终端执行scons、pkgs、menuconfig命令；

- 支持在资源管理器上右键，选择“在此处打开ConEmu”。

- 新增 路径规则支持用`${userHome}`表示当前用户的主目录。

- 新增 搜索RT-Thread Studio安装目录下的调试器路径时，添加搜索openocd。

- 新增 RT-Thread Studio类型的项目支持在资源管理器右键菜单 - 添加到头文件搜索路径。

- 新增 扩展设置项：

- Env方式支持自定义下载和调试时所用的产物路径。

- 使用Env方式时，保存配置时是否自动更新软件包。

- 自定义任务和终端中额外的环境变量（如果相同则覆盖）。

- 状态栏图标是否显示标题。

> **提示**
      >
      > 如果状态栏的按钮过多，可取消选中此设置。或者，在状态栏按钮右键隐藏不常用的。

- 新增 将状态栏的所有按钮的命令导出，支持通过命令面板（`Ctrl+Shift+P`）运行

- 优化 扩展设置项除了“RT-Thread Studio”安装路径以外，都允许在账户云同步。

- 优化 如果在vscode设置修改了扩展设置，提示是否重新加载vscode窗口或重新生成配置。

- 移除 引用用户主目录使用`~`的方式（请改成`${userHome}`）、引用环境变量使用`${VAR_NAME}`的方式（请写成`${env:VAR_NAME}`） **（破坏性变更）** 。

## 快速开始

1. 在vscode中安装并启用本扩展（`jswyll.jswyll-vscode-rtthread`），依赖的扩展会被自动安装。

2. 打开项目根目录（`.cproject`或`rt_config.py`文件的所在文件夹），点击状态栏的“导入”按钮

![images/1735660800001.png](https://oss-club.rt-thread.org/uploads/20250102/043b6c2058f1852249ce874f7470f7cf.png.webp)

3. 根据配置面板提示填写相关信息

点击“RT-Thread Studio路径”右方的打开文件按钮，选择RT-Thread Studio安装路径（`studio.exe`的所在文件夹）

根据情况选择调试器类型及其接口

点击“生成”按钮

![images/1735660800002.gif](https://oss-club.rt-thread.org/uploads/20250102/11cfa28b30b20f36f3bf44cbc188e8d4.gif)

4. 点击状态栏的“构建并下载”按钮（或按快捷键`Ctrl+Shift+B`）

![images/1735660800003.gif](https://oss-club.rt-thread.org/uploads/20250102/e7bb409cbcff8b00654a6eff19bd70c3.gif)

## 扩展特性

- 解析项目信息，生成vscode的配置文件：

- 可视化：通过配置向导面板进行输入或选择参数。从环境变量`PATH`中寻找可用的GCC编译器；Windows环境下选择RT-Thread Studio路径后，自动寻找GCC编译器路径、Make工具路径、调试器服务器等以供选择

- 代码浏览：生成C/C++浏览配置（`.vscode/c_cpp_properties.json`）的宏定义、头文件（搜索）路径；根据排除路径生成vscode资源管理器排除规则（`files.exclude`）。

- 冷启动运行Env相关命令：可直接打开项目目录在终端运行`scons`、`pkgs`、`sdk`、`menuconfig`命令（无须先打开ComEmu输入`code .`）。

- [菜单配置](#菜单配置)：可视化操作替代menuconfig。

- 程序编译：

- 多进程编译加快速度；如果make的主版本号大于4，添加`--output-sync=target`避免不同文件的编译报错混淆。

- 屏蔽编译和链接的一长串参数输出，并添加形如Keil IDE的编译与链接提示：

```sh
      compiling ../rt-thread/src/clock.c...
      compiling ../rt-thread/src/components.c...
      compiling ../rt-thread/src/device.c...
      compiling ../applications/main.c...
      linking ...
      arm-none-eabi-objcopy -O binary "rtthread.elf"  "rtthread.bin"
      arm-none-eabi-size --format=berkeley "rtthread.elf"
      text    data     bss     dec     hex filename
      55400    1468    3368   60236    eb4c rtthread.elf
      ```

- 提供更准确的问题匹配器，避免在问题面板打开出错文件跳转失败

- 下载程序：调试服务器类型支持Segger JLink、PyOCD、OpenOCD（前两个Windows环境下RT-Thread Studio已经内置），调试器类型支持常用的JLink、ST-Link、CMSIS-DAP。

- 调试程序：调试所支持的调试器类型和下载程序的一样；生成[Cortex-Debug](https://marketplace.visualstudio.com/items?itemName=marus25.cortex-debug)扩展的调试启动配置。

![images/1735660800004.png](https://oss-club.rt-thread.org/uploads/20250102/b8b86d3979478f07c56e7c8b8d0c1542.png.webp)

- [跨平台开发](#其它平台)：已在Windows、MacOS（10.13和15.2）、Linux（Ubuntu 24.04）上测试通过。

- [检查中断函数](#中断检查)：检查形如`void xxx_IRQHandler(void)`的函数是否调用了`rt_interrupt_enter()`和`rt_interrupt_leave()`。

- 国际化：支持简体中文和英文。

## 操作说明

vscode支持[多根工作区](https://code.visualstudio.com/docs/editor/multi-root-workspaces)，可以在一个工作区中同时打开多个工程。

本扩展兼容多根工作区。如果打开的是多根工作区且有多个根文件夹，将弹出工作区文件夹的选择器：

![images/1735660800005.png](https://oss-club.rt-thread.org/uploads/20250102/9905e3b37f6046c046c700d166e54406.png.webp)

后续的操作都将基于该文件夹，相关的配置文件会保存在该工作区文件夹。可以通过点击状态栏的子模块图标来再次切换。

> **说明**
>
> 以下所提到的“工作区文件夹”都是指已选择的根文件夹。如果打开的是单个文件夹或多根工作区下只有一个根文件夹，“工作区文件夹”就是指这个文件夹。

### 扩展激活

启用扩展后，当工作区文件夹中（第一级）有`.cproject`文件或`rt_config.py`文件时，扩展会自动激活。

> **提示**
>
> - 如果选择的构建方式RT-Thread Studio Makefile，需要在RT-Thread Studio构建一次。
>
> - 在vscode打开的主目录应该是BSP主目录或RT-Thread Studio项目的主目录。如果不是（例如想同时看RT-Thread主仓库源码和BSP），可参考[子文件夹](#子文件夹)将项目转为多根工作区。
>
> - BSP的Kconfig中的路径可能是导入后的，如果在RT-Thread主仓库中的BSP开发，可以尝试使用RT-Thread Studio导入项目或使用`scons --dist`相关命令生成标准的目录结构。

### 导入项目

点击状态里的“导入”（生成）来生成vscode的配置文件。

> **说明**
>
> - 重复生成应该是没有副作用的，需要修改或更新选项的时候可以再生成。
>
> - 项目可以是已经移动的（不在RT-Thread Studio workspace文件夹中的）。

#### 面板选项

- **项目类型**：项目的构建方式，`RT-Thread Studio`（eclipse Makefile）或`RT-Thread Env`（scons）。

- **构建配置**：在RT-Thread Studio项目中创建的构建配置。如果只有一个则无需选择。必要项。

- **RT-Thread Studio路径**：你的RT-Thread Studio安装路径（`studio.exe`的所在文件夹）。目前仅用于推导可能的工具位置以供选择。非Windows平台没有这个选项。非必要项。

- **GCC编译器路径**：用于C/C++扩展分析代码、编译程序。必要项。

可以直接选择RT-Thread Studio内置的5.4.1和10.3.1的arm-none-eabi两个版本：

![images/1735660800006.png](https://oss-club.rt-thread.org/uploads/20250102/2161f211bd45748b0aad79ebe7be6a65.png.webp)

对于ARM架构的芯片，可以前往<https://developer.arm.com/downloads/-/gnu-rm>下载特定的版本。

- **Make工具路径**：用于构建项目。非必要项（如果你只想浏览代码）。

可以选择RT-Thread Studio内置的`platform/env_released/env/tools/BuildTools/2.12-20190422-1053/bin`。Windows平台可以前往<https://github.com/skeeto/w64devkit/releases>下载命令更丰富的开发包。

- **芯片名称**：用于下载程序时让调试器识别出对应的FLASH大小。对于STM32，应至少精确到11位字符，例如`STM32L431CC`。

- **调试服务器**：支持OpenOCD、JLink、ST-LINK_gdbserver、PyOCD。非必要项（如果你不需要在vscode下载、调试程序）。

![images/1735660800007.png](https://oss-club.rt-thread.org/uploads/20250102/0fd5d67a97daf60c20094a4161371cc3.png.webp)

- Segger JLink：**要求版本大于等于V7.90**，RT-Thread Studio v2.2.8以上可以选内置的v7.92。或者，前往<https://www.segger.com/downloads/jlink>下载特定的版本。特点是：快！

![images/1735660800008.png](https://oss-club.rt-thread.org/uploads/20250102/bf96186c71bf3c592d0a30ea9b85d7c1.png.webp)

![images/1735660800009.png](https://oss-club.rt-thread.org/uploads/20250102/db81f82266e87f354e0d7ba8ae672266.png.webp)

- OpenOCD：可以前往<https://github.com/xpack-dev-tools/openocd-xpack/releases>下载，对于Windows还可以前往<https://gnutoolchains.com/arm-eabi/openocd/>下载包含的额外驱动软件的。支持ST-Link、JLink和CMSIS-DAP。特点是：很多芯片厂商都支持。

![images/1735660800011.png](https://oss-club.rt-thread.org/uploads/20250102/b9c0d767c12ba5f6394969f29e8dd9ae.png.webp)

> **说明**
    >
    > Windows平台选择OpenOCD调试服务器且使用JLink调试器时，需要使用<https://gnutoolchains.com/arm-eabi/openocd/>里的`UsbDriverTool.exe`或[zadig](https://zadig.akeo.ie/)把JLink驱动更换为libusb：
    >
    > ![images/1735660800012.gif](https://oss-club.rt-thread.org/uploads/20250102/622cbfb446d0fa9488b72114ca0c514c.gif)
    >
    > 修改驱动后在MDK IDE就不能使用JLink下载了，可以使用<https://gnutoolchains.com/arm-eabi/openocd/>里的`UsbDriverTool.exe`把驱动恢复为JLlink驱动：
    >
    > ![images/1735660800013.gif](https://oss-club.rt-thread.org/uploads/20250102/3e15618316a18265e77f936cb5f4fd67.gif)

- ST-LINK_gdbserver：支持在RT-Thread Studio的SDK Manager安装的或通过官网 [STM32CubeCLT页面](https://www.st.com.cn/zh/development-tools/stm32cubeclt.html)下载安装的。经测试，通过RT-Thread Studio安装的 **1.4.0 和 1.2.0 版本只能下载，启动调试失败。** 默认内置的1.6.0版本及更高的版本可用。

- PyOCD：可以选择RT-Thread Studio内置的v0.1.3。但经测试它不支持我的JLink，可以参考<https://pyocd.io/docs/installing>安装最新的新版本（Windows平台pip安装的pyocd可能需要拷贝libusb.dll到python根目录才可用），新版本对ST-Link、JLink和CMSIS-DAP调试器都支持。

除非是[PyOCD内置目标](https://pyocd.io/docs/builtin-targets.html)，否则需要填写Cmsis包的路径。Windows平台可以输入关键词然后选择RT-Thread Studio内置的。

![images/1735660800010.png](https://oss-club.rt-thread.org/uploads/20250102/6c6987670d9ab203b247bda45cb137c7.png.webp)

> **提示**
    >
    > 可以通过pyocd命令添加内置的支持包：`pyocd pack find 芯片名称`查找，`pyocd pack install 包名称`安装。例：
    >
    > ```sh
    > D:\RT-ThreadStudio\workspace\stm32f407-atk-explorer-v5.2.0>pyocd pack find STM32F407ZG
    > 0000455 I No pack index present, downloading now... [pack_cmd]
    > Part            Vendor               Pack                 Version   Installed  
    > ---------------------------------------------------------------------------------
    > STM32F407ZGTx   STMicroelectronics   Keil.STM32F4xx_DFP   3.0.0     False      
    > 
    > D:\RT-ThreadStudio\workspace\stm32f407-atk-explorer-v5.2.0>pyocd pack install STM32F407ZGTx
    > Downloading packs (press Control-C to cancel):
    >     Keil.STM32F4xx_DFP.3.0.0
    > Downloading descriptors (001/001)
    > 
    > D:\RT-ThreadStudio\workspace\stm32f407-atk-explorer-v5.2.0>
    > ```
    >
    > 添加后不需要填写Cmsis包的路径。

> **说明**
>
> 以上的**xxx路径**选项，你可以通过右方的打开文件图标按钮来选择，可以选择提示的选项，还可以手动输入，见[路径规则](#路径规则)。

#### 开始生成

填写参数的过程中会校验输入是否有效。对于错误，根据提示检查并更正。

![images/1735660800014.png](https://oss-club.rt-thread.org/uploads/20250102/68cc570b751f43448d574480581b2e7a.png.webp)

对于警告，点击“生成”时会弹窗提示，如果确定可以点击“忽略”按钮。

![images/1735660800015.png](https://oss-club.rt-thread.org/uploads/20250102/d19c8ffc78d445297b6fa523a69c3038.png.webp)

![images/1735660800016.png](https://oss-club.rt-thread.org/uploads/20250102/823a1619ebdb467df86fc6d6c38bce21.png.webp)

点击“生成”按钮，开始校验并生成配置文件。如果生成成功，配置面板将自动关闭。

> **注意**
>
> **切换编译器版本后，应重新编译，以消除编译器版本差异引发不可预料的结果。比如，RT-Thread Studio默认使用的是GCC 5.4.1，在vscode选择RT-Thread Studio内置的env_released/env/tools/gnu_gcc/arm_gcc/mingw/bin/arm-none-eabi-gcc.exe是GCC 10.3.1，在RT-Thread Studio构建或再次构建过然后又转到vscode构建。在比如，在vscode前后两次生成配置时选择的GCC的版本不一样。**

### 构建项目

可以点击状态栏的图标`清除`、`构建`、`下载`或`构建并下载`来执行构建任务。

也可以在菜单栏->终端->运行任务...来选择`重新构建`任务。

![images/1735660800017.png](https://oss-club.rt-thread.org/uploads/20250102/8dc6da39a0883820f3576e2f2bebdc54.png.webp)

[导入项目](#导入项目)时如果指定了默认构建任务，可以按快捷键`Ctrl+Shift+B`来执行。

![images/1735660800018.png](https://oss-club.rt-thread.org/uploads/20250102/92498adca12c870850586d30b62f51f9.png.webp)

任务结束时会提示结果及耗时。

![images/1735660800019.png](https://oss-club.rt-thread.org/uploads/20250102/1c8b072ce498490a6b57c256f32c7689.png.webp)

> **提示**
>
> 构建失败时你可以在终端或问题面板跳转到对应的文件位置：
>
> ![images/1735660800020.png](https://oss-club.rt-thread.org/uploads/20250102/fe25f9d52b8bf6430a37bc6ca65735a5.png.webp)
>
> ![images/1735660800021.png](https://oss-club.rt-thread.org/uploads/20250102/3f365e7540813be02a1bff61f30f4c23.png.webp)
>
> 修改代码后vscode不会立刻移除错误标记，需要再次执行构建任务。

### 下载运行

可以安装微软的“串行监视器”扩展来查看串口输出或当作终端来操作：

```plaintext
名称: Serial Monitor
ID: ms-vscode.vscode-serial-monitor
说明: Send and receive text from serial ports.
发布者: Microsoft
VS Marketplace 链接: https://marketplace.visualstudio.com/items?itemName=ms-vscode.vscode-serial-monitor
```

![images/1735660800022.gif](https://oss-club.rt-thread.org/uploads/20250102/da50652edd00271ad827529a20e032aa.gif)

### 调试代码

按F5键或“菜单栏->运行->启动调试”来开始调试。

除了常规的GDB调试功能以外，Cortex-Debug扩展还支持查看内存、片上外设寄存器等功能，详情请查看[Cortex-Debug文档](https://marketplace.visualstudio.com/items?itemName=marus25.cortex-debug)。

可以在vscode扩展搜索`Cortex Debug Device Support Pack`安装对应芯片系列的片上外设支持包。

> **提示**
>
> 调试任务启动前会调用默认构建任务，调试任务启动时会下载程序，所以启动或重启调试任务无需先点击构建或下载。

### 目录检测

选择RT-Thread Studio构建方式时，对于已加入编译的文件夹，当文件夹内（第一级）有新增或移除的文件时，会自动更新对应的makefile规则。

![images/1735660800023.png](https://oss-club.rt-thread.org/uploads/20250102/cbd2d4cfa8f8df5892be7ec5239a25f0.png.webp)

可以在扩展设置中关闭。

> **说明**
>
> 本扩展开发时参考了[eclipse-cdt - gnu2/GnuMakefileGenerator.java](https://github.com/eclipse-cdt/cdt/blob/main/build/org.eclipse.cdt.managedbuilder.core/src/org/eclipse/cdt/managedbuilder/makegen/gnu2/GnuMakefileGenerator.java)自动生成makefile的源码，目前只实现了更新它已经生成的makefile。如果自动更新有问题，可以在扩展设置中关闭此功能，然后在RT-Thread Studio构建项目一次，相关的文件会还原为GnuMakefileGenerator自动生成的值。

## RT-Thread Env

### 先决条件

1. 已安装好Env。

> **提示**
    >
    > - 对于Env Windows v2.x联网环境方式，需要先运行一次env.exe或env.ps1以下载相关依赖和虚拟环境。
    >
    > - Ubuntu或MacOS的Env安装方式可参考[其它平台](#其它平台)。

2. 支持scons方式编译的项目。本扩展支持Env v1.x和v2.x，但取决于BSP能使用的Env版本。

打开BSP的所在文件夹（`BSP_DIR`），例如：

- 第一种：已经是RT-Thread标准项目框架的：

```sh
    stm32f407-atk-explorer/ # BSP_DIR
    ├── applications/
    ├── packages/  # PKGS_DIR (PKGS_ROOT)
    ├── rt-thread/ # RTT_DIR
    ├── ...
    ├── Kconfig
    ├── SConscript
    ├── SConstruct
    ├── rtconfig.h
    └── rtconfig.py
    ```

- 第二种：是RT-Thread仓库下的某个BSP：

```sh
    rt-thread/ # RTT_DIR
    ├── bsp/
    │   └── stm32/
    │       ├── libraries/
    │       ├── ...
    │       └── stm32f407-atk-explorer # BSP_DIR
    │          ├── applications/
    │          ├── packages/ # PKGS_DIR (PKGS_ROOT)
    │          ├── ...
    │          ├── Kconfig
    │          ├── SConscript
    │          ├── SConstruct
    │          ├── rtconfig.h
    │          └── rtconfig.py
    ├── ...
    ├── src/
    ├── tools/
    └── Kconfig
    ```

### 生成配置

1. 点击状态栏的“导入”图标按钮，弹出配置面板：

![images/1735660800032.png](https://oss-club.rt-thread.org/uploads/20250116/ac7030c933aaff75f59b69ece1a69e07.png.webp)

- **Env工具路径**：`ENV_ROOT`，即`tools`文件夹的所在文件夹。例：

- `c:/env-windows`（v2.x 离线环境方式安装）

- `E:/BaiduNetdiskDownload/env-windows-v2.0.0/env-windows`（v2.x 联网环境方式安装）

- `C:/Users/jswyll/.env`或`${userHome}/.env`（v2.x [powershell方式安装](https://github.com/RT-Thread/env)）

- `E:/BaiduNetdiskDownload/env_released_1.3.5_gcc10_python2/env-windows-v1.3.5`（v1.x 无需虚拟环境）

- **RTT根目录**：`RTT_DIR`，RT-Thread源码的主目录。以前面的BSP`stm32f407-atk-explorer`为例，第一种填`rt-thread`，第二种情况填`../../..`。

2. 其它选项与RT-Thread Studio的配置方式一致。

3. 点击“生成”按钮并等待生成完毕。

如果操作无误状态栏应显示“配置”和“终端”图标按钮：

![images/1735660800033.png](https://oss-club.rt-thread.org/uploads/20250116/f82a4f25cbbdf000a36dc60b7ddbdd94.png)

> **说明**
>
> RT-Thread Env构建方式的默认产物路径是`rt-thread.elf`，如果名称不同或路径不同可以在扩展设置`jswyll-vscode-rtthread.generate.artifactPath`修改下载和调试时所用的产物路径。

### 菜单配置

> **说明**
>
> 对于Env v2.x，安装好依赖后，除非本扩展无法正常使用，否则 **无需** 运行`${ENV_ROOT}/env.ps1`或`${ENV_ROOT}/.venv/Scripts/Activate.ps1`激活虚拟环境。

1. 点击状态栏的“配置”图标按钮，弹出菜单配置面板：

![images/1735660800034.png](https://oss-club.rt-thread.org/uploads/20250116/43f99929b460bb5ae8af031751f85bde.png.webp)

2. 单击菜单项的标题（或最左边侧的图标）可以展开或折叠菜单，有几类配置项：

- 整数（`int`）

- 十六进制数（`hex`）

- 字符串（`string`）

- 布尔（`bool`）

- 单项选择（`choice`）

![images/1735660800035.png](https://oss-club.rt-thread.org/uploads/20250116/b7741697850b1bc8641ea8525f71e46a.png.webp)

3. 可以在搜索框中输入关键词搜索配置项（或菜单项）：

![images/1735660800036.png](https://oss-club.rt-thread.org/uploads/20250116/032a0b7dc36a60383b3bf2ff90e02c2a.png.webp)

关键词可以是以下之一中的字词：

- 名称，例如`RT_NAME_MAX`

- 标题，例如`The maximal size of kernel object name`，

- 帮助，例如`Each kernel object, such as thread, timer, semaphore etc, has a name,the RT_NAME_MAX is the maximal size of this object name.`

- 翻译后的标题，例如`内核对象名称的最大大小`

- 翻译后的帮助，例如`每个内核对象，如线程、定时器、信号量等，都有一个名称。 RT_NAME_MAX是该对象名称的最大大小。`

> **提示**
    >
    > 如果修改了Kconfig文件，可以点“重新加载”按钮来刷新菜单配置。
    >
    > 可参考[linux内核Kconfig文档](https://www.kernel.org/doc/html/latest/kbuild/kconfig-language.html)了解Kconfig语法。

4. 点击“保存”按钮保存配置，默认自动更新软件包：

![images/1735660800037.gif](https://oss-club.rt-thread.org/uploads/20250116/e0bd73dba8c9f1e0e8ce4bd1d4c1a63a.gif)

> **说明**
    >
    > - 可以在 菜单栏 -> 终端 -> 运行任务... 手动运行该任务：
    >
    >     ![images/1735660800038.png](https://oss-club.rt-thread.org/uploads/20250116/f1ade042d7221b9bc50e824ab957054d.png.webp)
    >
    > - 可以在扩展设置中关闭保存配置时自动更新软件包。

> **提示**
>
> `RTT_CC`的默认值是`gcc`。
>
> 可以在扩展设置中添加环境变量，名称相同的可覆盖扩展生成的。

### 终端任务

清除、构建、下载、调试的操作方式与RT-Thread Studio类型的一致。本质上是运行定义的`tasks.json`中的任务，可以通过点击状态栏图标按钮、菜单栏、配置快捷键、使用任务扩展等方式运行终端任务。

![images/1735660800039.png](https://oss-club.rt-thread.org/uploads/20250116/76d58ef4674faf7d4c9d2322b1ae8888.png.webp)

### 集成终端

- 点击状态栏的“终端”图标按钮，弹出终端面板。可以使用scons、pkgs、sdk、menuconfig命令。

![images/1735660800040.png](https://oss-club.rt-thread.org/uploads/20250408/a4ced6dba18e88234307cae5cc75fad8.png.webp)

在Win10的vscode终端执行menuconfig有[已知问题](#已知问题)：

![images/1735660800041.png](https://oss-club.rt-thread.org/uploads/20250408/509459423de1e52181e8f90496d1c777.png.webp)

- 也可以通过点击终端面板右上角的下拉图标来打开终端。

![images/1735660800042.png](https://oss-club.rt-thread.org/uploads/20250408/624779c20aa779b994b21f9921d5b599.png.webp)

### 原始方式

可以在vscode资源管理器上（文件或文件夹）右键，选择“在此处打开ConEmu”，使用原始方式开发：

![images/1735660800043.png](https://oss-club.rt-thread.org/uploads/20250116/d029e17cbf6fc677e14169fb4319a144.png)

![images/1735660800044.png](https://oss-club.rt-thread.org/uploads/20250116/041fa24ddfc791cf8ad6c5dca6f7e3ca.png.webp)

## 更佳实践

本扩展只实现了一小部分功能，可能不满足实际的需求，可以在生成的基础上进行修改；或者，使用其它扩展进行嵌入式开发。不管怎样，以下的操作和建议应该是通用的。

### 其它平台

- Linux发行版（以Ubuntu为例）

1. 切换apt源（非必要项）。参考[阿里云 - Ubuntu 镜像](https://developer.aliyun.com/mirror/ubuntu?spm=a2c6h.13651102.0.0.68a51b11PeE4rU)修改系统配置，加快下载速度。

2. GCC工具链。

在<https://developer.arm.com/downloads/-/gnu-rm>下载预构建的linux的，例如x86/64架构可以下载[gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2](https://developer.arm.com/-/media/Files/downloads/gnu-rm/10.3-2021.10/gcc-arm-none-eabi-10.3-2021.10-x86_64-linux.tar.bz2?rev=78196d3461ba4c9089a67b5f33edf82a&hash=5631ACEF1F8F237389F14B41566964EC)并解压。

> **提示**
    >
    > 旧版本的`gcc-arm-none-eabi-gdb`依赖于`libncurses.so.5`库，而Ubuntu18以后已经移除，可以链接到`libncurses.so.6`库：
    >
    > ```sh
    > # 例如10.3.1，假设解压到了 ~/Desktop/software/gcc-arm-none-eabi-10.3-2021.10
    > 
    > ~/Desktop/software/gcc-arm-none-eabi-10.3-2021.10/bin/arm-none-eabi-gdb -v
    > # 报错arm-none-eabi-gdb: error while loading shared libraries: libncurses.so.5: cannot open shared object> file: No such file or directory
    > 
    > # 查看依赖
    > ldd ~/Desktop/software/gcc-arm-none-eabi-10.3-2021.10/bin/arm-none-eabi-gdb
    > #         linux-vdso.so.1 (0x00007fffe41eb000)
    > #         libncurses.so.5 => not found
    > #         libtinfo.so.5 => not found
    > #         libdl.so.2 => /lib/x86_64-linux-gnu/libdl.so.2 (0x000074afbe2ec000)
    > #         libstdc++.so.6 => /lib/x86_64-linux-gnu/libstdc++.so.6 (0x000074afbe000000)
    > #         libm.so.6 => /lib/x86_64-linux-gnu/libm.so.6 (0x000074afbdf17000)
    > #         libgcc_s.so.1 => /lib/x86_64-linux-gnu/libgcc_s.so.1 (0x000074afbe2bc000)
    > #         libpthread.so.0 => /lib/x86_64-linux-gnu/libpthread.so.0 (0x000074afbe2b7000)
    > #         libc.so.6 => /lib/x86_64-linux-gnu/libc.so.6 (0x000074afbdc00000)
    > #         /lib64/ld-linux-x86-64.so.2 (0x000074afbe303000)
    > 
    > # 说明缺少libncurses.so.5和libtinfo.so.5，查找其它可用的libncurses
    > sudo find / -name 'libncurses.so.*'
    > # /usr/lib/x86_64-linux-gnu/libncurses.so.6
    > sudo find / -name 'libtinfo.so.*'
    > # /usr/lib/x86_64-linux-gnu/libtinfo.so.6
    > # 创建软链接
    > sudo ln -s /usr/lib/x86_64-linux-gnu/libncurses.so.6 /lib/x86_64-linux-gnu/libncurses.so.5
    > sudo ln -s /usr/lib/x86_64-linux-gnu/libtinfo.so.6 /lib/x86_64-linux-gnu/libtinfo.so.5
    > 
    > # 验证
    > ~/Desktop/software/gcc-arm-none-eabi-10.3-2021.10/bin/arm-none-eabi-gdb -v
    > # GNU gdb (GNU Arm Embedded Toolchain 10.3-2021.10) 10.2.90.20210621-git
    > # Copyright (C) 2021 Free Software Foundation, Inc.
    > # License GPLv3+: GNU GPL version 3 or later <http://gnu.org/licenses/gpl.html>
    > # This is free software: you are free to change and redistribute it.
    > # There is NO WARRANTY, to the extent permitted by law.
    > ```

3. make。一般是内置的，可以用`make -v`查看版本，如果小于4.0，建议用`sudo apt update && sudo apt install --reinstall make`升级到最新版本。

4. 调试服务器。

- OpenOCD：

```sh
        # 安装OpenOCD，安装后openocd会被添加到环境变量PATH。
        sudo apt install openocd
        ```

- Jlink：

在<https://www.segger.com/downloads/jlink>下载并安装Linux的安装包，例如`https://www.segger.com/downloads/jlink/JLink_Linux_x86_64.deb`。

安装后位于`/opt/SEGGER/JLink/JLinkExe`，会将JLinkExe添加到环境变量PATH。

- python3、env2.x与pyocd:

可复制以下命令到终端按回车执行一键安装

```sh
        cat << 'EOF' > install_ubuntu.sh
        #!/usr/bin/env bash

sudo apt-get update
        sudo apt-get -qq install python3 python3-venv gcc git libncurses5-dev -y

wget $url -O touch_env.sh
        chmod 777 touch_env.sh
        ./touch_env.sh  $@
        rm touch_env.sh

python3 -m venv ~/.env/.venv
        source ~/.env/.venv/bin/activate
        pip install scons requests tqdm kconfiglib pyyaml pyocd
        python3 -m pip install -U pyocd
        EOF
        chmod +x install_ubuntu.sh
        ./install_ubuntu.sh --gitee
        rm ./install_ubuntu.sh
        ```

> **说明**
        >
        > 此处命令行脚本参考<https://github.com/RT-Thread/env/blob/master/install_ubuntu.sh>并改为虚拟环境的方式。

- MacOS

1. 安装包管理器

```sh
    /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
    ```

或者，参考brew安装文档`https://docs.brew.sh/Installation`。

2. GCC工具链。

在<https://developer.arm.com/downloads/-/gnu-rm>下载预构建的MacOS的，例如下载[gcc-arm-none-eabi-10.3-2021.10-mac.pkg](https://developer.arm.com/-/media/Files/downloads/gnu-rm/10.3-2021.10/gcc-arm-none-eabi-10.3-2021.10-mac.pkg?rev=b382d51ec8d34c3fa421cf57ce97f146&hash=86689FEB39DA7A381FF78A2E70F7ABCE)然后安装。安装后位于`/Applications/ARM/bin/arm-none-eabi-gcc`。

3. make。一般是内置的，可以用`make -v`查看版本，如果小于4.0，建议用`brew install make`升级到最新版本。

> **提示**
    >
    > 比较新的版本的GNU“make”可能安装在`/usr/local/opt/make/libexec/gnubin/make`。

4. 调试服务器

- OpenOCD：

```sh
        # 安装openocd，安装后openocd会被添加到环境变量PATH。
        brew install open-ocd
        ```

- JLink：

在<https://www.segger.com/downloads/jlink>下载并安装macOS的`JLink_MacOSX_Vxxx_universal.pkg`文件。

安装后位于`/Applications/SEGGER/JLink_Vxxx/JLinkExe`

- python3、env2.x与pyocd:

可复制以下命令到终端按回车执行一键安装

```sh
        cat << 'EOF' > ./install_macos.sh
        #!/usr/bin/env bash

if ! [ -x "$(command -v brew)" ]; then
            echo "Installing Homebrew."
            /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
        fi

brew update
        brew upgrade

RTT_PYTHON=python3

$RTT_PYTHON --version >/dev/null 2>&1 || {
            echo "Installing python3."
            brew install python3
        }

if ! [ -x "$(command -v git)" ]; then
            echo "Installing git."
            brew install git
        fi

brew list ncurses >/dev/null || {
            echo "Installing ncurses."
            brew install ncurses
        }

if ! [ -x "$(command -v arm-none-eabi-gcc)" ]; then
            echo "Installing GNU Arm Embedded Toolchain."
            brew install gnu-arm-embedded
        fi

url=https://raw.githubusercontent.com/RT-Thread/env/master/touch_env.sh
        if [ $1 ] && [ $1 = --gitee ]; then
            url=https://gitee.com/RT-Thread-Mirror/env/raw/master/touch_env.sh
        fi
        curl $url -o touch_env.sh
        chmod 777 touch_env.sh
        ./touch_env.sh $@
        rm touch_env.sh

python3 -m venv ~/.env/.venv
        source ~/.env/.venv/bin/activate

$RTT_PYTHON -m pip list >/dev/null || {
            echo "Installing pip."
            $RTT_PYTHON -m ensurepip --upgrade
        }

if ! [ -x "$(command -v scons)" ]; then
            echo "Installing scons."
            $RTT_PYTHON -m pip install scons
        fi

if ! [ -x "$(command -v tqdm)" ]; then
            echo "Installing tqdm."
            $RTT_PYTHON -m pip install tqdm
        fi

if ! [ -x "$(command -v kconfiglib)" ]; then
            echo "Installing kconfiglib."
            $RTT_PYTHON -m pip install kconfiglib
        fi

if ! [ -x "$(command -v pyocd)" ]; then
            echo "Installing pyocd."
            $RTT_PYTHON -m pip install -U pyocd
        fi

if ! [[ $($RTT_PYTHON -m pip list | grep requests) ]]; then
            echo "Installing requests."
            $RTT_PYTHON -m pip install requests
        fi
        EOF
        chmod +x ./install_macos.sh
        ./install_macos.sh --gitee
        rm ./install_macos.sh
        ```

> **说明**
        >
        > 此处命令行脚本参考<https://github.com/RT-Thread/env/blob/master/install_macos.sh>并改为虚拟环境的方式。

### 路径规则

支持的路径表达方式：

- 绝对路径。例如：

```sh
    D:/RT-ThreadStudio/repo/Extract/ToolChain_Support_Packages/ARM/GNU_Tools_for_ARM_Embedded_Processors/5.4.1/bin/arm-none-eabi-gcc.exe
    ```

- 用户主目录下的路径，例如`${userHome}/env/.venv/Scripts`。

- 相对于工作区文件夹的路径。例如`tools/make.exe`。

- 已添加到[环境变量](#环境变量)`PATH`中的路径。例如openocd工具在`D:/openocd-v0.12.0-i686-w64-mingw32/bin/openocd.exe`，把`D:/openocd-v0.12.0-i686-w64-mingw32/bin`添加到环境变量`PATH`中后，可以填写`openocd.exe`。

- 可以[引用环境变量](https://code.visualstudio.com/docs/editor/variables-reference#_environment-variables)。

> **说明**
>
> 优化建议：
>
> - 虽然Windows的路径分隔符是反斜杠`\`、Linux和MacOS的路径分隔符是斜杠`/`，但在Windows中绝大多数程序都能识别`/`；反而，在Windows中有些程序和命令行会将`\`视为拼接转义（例如`E:\workspace/foo\bar`被解析为`E:workspace/foobar`）从而导致编译失败。因此，可以统一使用`/`。
>
> - 在Windows选择文件路径时，可以省略`.exe`后缀。
>
> - 如果指定的绝对路径与工作区文件夹在同一盘符内，尝试将绝对路径转为相对路径。
>
> 生成配置文件时本扩展会按照这些建议优化路径。

### 环境变量

在跨平台或团队协作中，不同的环境下的工具、库等路径可能不同。如果工具位于项目根目录下，可以引用相对路径；如果在其它路径，引用绝对路径要求每个环境的路径都一样，这显然不太可能。使用环境变量可以解决这种问题。

> **说明**
>
> Windows平台powershell中可以用`Get-ChildItem Env:`来查看环境变量；Linux或MacOS中可以用`printenv`来查看环境变量。

最常见的环境变量是`PATH`，它列举多个文件夹的路径，可以让程序通过环境变量找到需要的工具。例如ARM GCC10.3.1工具的`arm-none-eabi-gcc.exe`位于`D:\gcc-arm-none-eabi-10.3-2021.10\bin`文件夹，则可以：

1. 把`D:\gcc-arm-none-eabi-10.3-2021.10`追加到环境变量`PATH`中；

2. 使用arm-none-eabi-gcc命令时可以简写成`arm-none-eabi-gcc`。

如果有不同版本的`arm-none-eabi-gcc.exe`，可以为不同版本的各创建一个环境变量。例如ARM GCC10.3.1工具位于`D:\gcc-arm-none-eabi-10.3-2021.10\bin`文件夹，则可以：

1. 在系统中新建一个`ARM_NONE_EABI_GCC_V10_HOME`的环境变量取值为`D:\gcc-arm-none-eabi-10.3-2021.10`；

2. 使用arm-none-eabi-gcc命令时可以写成`${env:ARM_NONE_EABI_GCC_V10_HOME}\bin\arm-none-eabi-gcc.exe`。

> **说明**
>
> 步骤1的设置存在系统中，步骤2的存在于项目中，这就消除了在项目中的差异。

综上所述，建议：

- 如果不同项目所使用的工具的版本一样或版本差异对项目没有影响：将工具的所在文件夹添加到环境变量`PATH`中，使用时直接引用文件的基本名。例如`make`、`openocd`、`pyocd`、`Jlink`。

- 如果不同项目使用的工具的版本不一样：为每个版本的工具的所在文件夹创建一个环境变量。例如：

1. 三个版本的ARM GCC工具链分别位于

```sh
        D:\foo\gcc-arm-none-eabi-4_9-2015q3-20150921-win32
        D:\RT-ThreadStudio\repo\Extract\ToolChain_Support_Packages\ARM\GNU_Tools_for_ARM_Embedded_Processors\5.4.1
        D:\foo\bar\gcc-arm-none-eabi-10.3-2021.10
        ```

2. 在系统创建环境变量

```sh
        # 名称为ARM_NONE_EABI_GCC_V4_9_3_HOME，值为D:\foo\gcc-arm-none-eabi-4_9-2015q3-20150921-win32
        # 名称为ARM_NONE_EABI_GCC_V5_4_1_HOME，值为D:\RT-ThreadStudio\repo\Extract\ToolChain_Support_Packages\ARM\GNU_Tools_for_ARM_Embedded_Processors\5.4.1
        # 名称为ARM_NONE_EABI_GCC_V10_3_1_HOME，值为D:\foo\bar\gcc-arm-none-eabi-10.3-2021.10
        ```

3. 项目中使用的是v10.3.1版本的arm-none-eabi-gcc

```sh
        ${env:ARM_NONE_EABI_GCC_V10_3_1_HOME}/bin/arm-none-eabi-gcc
        ```

> **说明**
        >
        > Linux或MacOS的对应工具没有`.exe`后缀，省略掉可以提高兼容性。

团队协作中，不同成员的工具安装目录等配置很可能不同。虽然可以通过把`.vscode`、`*.code-workspace`加入`.gitignore`中来屏蔽不同团队成员的配置，但那样也损失了可共享的公用配置，如果没有完善的文档，若干年之后再`git clone`用起来或许连自己都要折腾几番。个人认为更好的方式是：

- 不把`.vscode`、`*.code-workspace`加入`.gitignore`忽略规则；

- 如果在不同项目中是通用的，有差异的设置保存在“用户”域中；

- 如果在不同项目中不是通用的，每个成员在系统中创建环境变量；

- 把剩余的小部分不可通用的（没有同步到远程仓库的）所需配置或产生配置的方式写在项目文档中。

例如，`stm32f407-atk-explorer-v5.0.0`项目决定用Env v2.0版本，每个成员把具体的Env版本的所在文件夹设为环境变量`RTT_ENV_V2`，然后在生成配置时“Env工具路径”填写`${env:RTT_ENV_V2}`、“GCC编译器路径”填写`${env:RTT_ENV_V2}/tools/gnu_gcc/arm_gcc/mingw/bin/arm-none-eabi-gcc`。

### 扩展设置

扩展设置的作用域分为用户、工作区、工作区文件夹3类。

在导入项目的面板生成配置时，自动保存的相关设置的作用域是工作区文件夹。

vscode设置的优先级是`工作区文件夹 > 工作区 > 用户 > 默认值`。可以在“用户”域修改默认值，为新的工作区文件夹提供自定义的默认值，就不需要在每次打开新的项目时重复配置。而且，在“用户”域修改的值不会保存到工作区文件夹中，可以提高团队协作时的项目兼容性。例如：

![images/1735660800024.png](https://oss-club.rt-thread.org/uploads/20250102/a441c3a6189e30c44caaeec443b62b46.png.webp)

### 中断检查

检查工作区文件夹下的源文件是否在每个`xxx_IRQHandler`函数中调用了`rt_interrupt_enter()`和`rt_interrupt_leave()`，不符合要求时，发出警告：

![images/1735660800025.png](https://oss-club.rt-thread.org/uploads/20250102/40b6cf9f1a461dbb021767b9134c326e.png.webp)

可以在`问题`面板中的警告上右键（或编辑器出现警告波浪线的地方点击`快速修复`），选择`添加所有缺少的调用`即可补齐该文件中的所有缺失的调用：

![images/1735660800026.gif](https://oss-club.rt-thread.org/uploads/20250102/faa08fc7f1f2e6b1ab112c8177014827.gif)

> **说明**
>
> 快速修复时，如果有`/* USER CODE BEGIN xxx */`、`/* USER CODE END xxx */`则添加到模板之间，否则添加到函数体的开头和结尾。

#### 触发条件

- 自动诊断：指定的路径（默认为`stm32*_it.c`）文件（例如`Core/Src/stm32f4xx_it.c`）中存在以下任意一行之一：

```c
    #include <rtthread.h>
    #include "rtthread.h"
    rt_interrupt_enter();
    rt_interrupt_leave();
    ```

> **说明**
    >
    > 可以在扩展设置中修改是否启用自动诊断及其路径匹配模式。例：
    >
    > - 全部源文件：`**/*.c`
    >
    > - `Core/Src`的全部源文件：`Core/Src/*.c`

- 手动诊断：资源管理器中的`.c`文件上右键，选择`诊断中断函数`。

![images/1735660800027.png](https://oss-club.rt-thread.org/uploads/20250102/c92703903de63244a44a7fdf93c73d9c.png.webp)

### 定制任务

如果本扩展生成的配置不满足需求，可以在`.vscode/tasks.json`、`.vscode/c_cpp_properties.json`、`.vscode/launch.json`添加任务，重新导入时不会被覆盖。

- 任务

```json
    {
        "tasks": [
            // ...
            {
                "label": "push",
                "detail": "推送",
                "command": "git",
                "args": [
                    "push",
                ],
                "problemMatcher": []
            }
        ]
    }
    ```

![images/1735660800028.png](https://oss-club.rt-thread.org/uploads/20250102/a1ee97cc677c0f1d7cf781de10dd37c2.png)

- 状态栏按钮

本扩展状态栏按钮的“清除”、“构建”、“下载”、“构建并下载”所执行的任务分别对应`.vscode/tasks.json`中任务如下`label`：

```sh
    jswyll-vscode-rtthread: clean
    jswyll-vscode-rtthread: build
    jswyll-vscode-rtthread: download
    jswyll-vscode-rtthread: build and download
    ```

重新导入时这些任务会被覆盖，如果要修改状态栏按钮的任务，可以定义不包含`jswyll-vscode-rtthread:`前缀的。例如定制“编译并下载”任务

```json
    {
        "tasks": [
            // ...
            {
                "label": "build and download",
                "detail": "构建、下载并暂存",
                "dependsOn": [
                    "jswyll-vscode-rtthread: build and download",
                ],
                "dependsOrder": "sequence",
                "command": "git",
                "args": [
                    "add",
                    ".",
                ],
                "problemMatcher": []
            }
        ]
    }
    ```

这表示先执行本扩展定义的“构建并下载”，然后执行自定义的命令。也可以自由定义依赖和命令，只要label符合要求。

- 调试

可以自行添加Cortex-Deubg扩展支持的其它调试器，或其它架构的调试配置。

```json
    {
        "version": "0.2.0",
        "configurations": [
            {
                "name": "Debug",
                // ...
            },
            {
                "name": "MyDebug",
                "cwd": "${workspaceFolder}",
                "toolchainPrefix": "arm-none-eabi",
                "executable": "Debug/rtthread.elf",
                "request": "launch",
                "type": "cortex-debug",
                "device": "STM32L431CCTx",
                "runToEntryPoint": "main",
                "servertype": "qemu",
                // ...
            }
        ]
    }
    ```

![images/1735660800029.png](https://oss-club.rt-thread.org/uploads/20250102/81b1753ccd142a2972cba316c69c58c9.png)

- C/C++配置

例：切换为使用`scons --target=vsc`生成的

![images/1735660800030.png](https://oss-club.rt-thread.org/uploads/20250102/f3d35ce4d0a6a8d387984416ce17559b.png.webp)

### 子文件夹

如果想在子文件夹进行本扩展的相关功能，可以按照下面的步骤转换为vscode[多根工作区](https://code.visualstudio.com/docs/editor/multi-root-workspaces)。

假设当前打开的文件夹的目录结构如下：

```sh
rt-thread/ # opened this folder
├── bsp/
│   └── stm32/
│       ├── libraries/
│       ├── ...
│       └── stm32f407-atk-explorer # BSP_DIR
│          ├── applications/
│          ├── packages/
│          ├── ...
│          ├── Kconfig
│          ├── SConscript
│          ├── SConstruct
│          ├── rtconfig.h
│          └── rtconfig.py
├── ...
├── src/
├── tools/
└── Kconfig
```

1. 如果还不是vscode工作区（`xxx.code-workspace`）：在vscode打开父级目录`workspace`；点击 vscode菜单栏 -> 文件 -> 将工作区另存为...，在弹出的保存窗口中填工作区的名称和位置，然后点击“保存”按钮就生成了一个vscode工作区（`xxx.code-workspace`）。

```sh
    rt-thread/ # .code-workspace root1
    ├── bsp/
    │   └── stm32/
    │       ├── libraries/
    │       ├── ...
    │       └── stm32f407-atk-explorer # BSP_DIR
    │          ├── applications/
    │          ├── packages/
    │          ├── ...
    │          ├── Kconfig
    │          ├── SConscript
    │          ├── SConstruct
    │          ├── rtconfig.h
    │          └── rtconfig.py
    ├── ...
    ├── src/
    ├── tools/
    └── Kconfig
    ```

2. 点击 vscode菜单栏 -> 文件 -> 将文件夹添加到工作区...，选择那个子文件夹（`BSP_DIR`）；

stm32f407-atk-explorer # .code-workspace root2 (BSP_DIR)
    ├── applications/
    ├── packages/
    ├── ...
    ├── Kconfig
    ├── SConscript
    ├── SConstruct
    ├── rtconfig.h
    └── rtconfig.py
    ```

3. 点击状态栏的子模块图标来选择当前的工作区文件夹为上一步加入多根工作区的文件夹（`.code-workspace root2`）。

> **说明**
    >
    > 以后在vscode打开步骤1的`xxx.code-workspace`。

4. 在`.code-workspace root1`继续后续操作。（在`.code-workspace root2`当然是可以的，它的物理路径和`.code-workspace root1`中的那个子文件夹的是一样的。）

## 常见问题

```sh
error: open failed
in procedure 'program'
** OpenOCD init failed **
shutdown command invoked
```

调试器已正确连接芯片和电脑？选择的调试器类型正确？已安装调试服务器（驱动）？

---

```sh
** Programming Started **
Error: couldn't open Debug/rtthread.elf
** Programming Failed **
shutdown command invoked
```

还没构建就点了下载。

---

```sh
process_begin: CreateProcess(NULL, echo " ", ...) failed.
make (e=2): 系统找不到指定的文件。
```

环境变量`PATH`中没有echo命令。Linux和MacOS是系统自带的，Windows选择了RT-Thread的make工具路径也是有的。

可以把RT-Thread的make工具路径添加到环境变量`PATH`中。或者，下载并解压<https://github.com/skeeto/w64devkit/releases>然后添加到环境变量`PATH`中。

---

## 使用限制

- 调试依赖于Cortex-Debug扩展，只支持ARM-Cortex架构（如果GCC编译器的前缀不是`arm-none-eabi-`将不生成调试配置`.vscode/launch.json`）。

- 暂不支持在资源管理器中右键添加新增编译的源文件文件夹，目前需要使用RT-Thread Studio构建一次后才会管理新增的源文件文件夹。

## 已知问题

- 如果在工作区启用Python扩展激活了虚拟环境且虚拟环境的python版本和选择的RT-Thread Env中的大版本不一致（v1.x是Python2，v2.x是Python3），很可能导致终端出错，因为Python扩展激活的Python的优先级更高。出现错误请修改Python扩展的设置关闭激活虚拟环境，或（在工作区）禁用Python扩展。

- 终端集成：

在Win10中，RT-Thread Env 2.x的menuconfig不支持用上下左右箭头来移动，进入子菜单请用`Enter`或`L`键；返回上一级请用`ESC`或`H`键；上、下请用`K`、`J`键；RT-Thread Env 1.x的menuconfig如何上下移动尚未清楚。

- 旧版本RT-Thread Studio内置的`J-Link/v7.50a`不支持解析elf文件，请使用以下方式之一升级到V7.90（2023-08-02）及以上版本：

- 使用RT-Thread Studio的SDK管理器安装高版本的J-Jlink；

- 升级RT-Thread Studio；

- 下载[新版本的Segger Jlink](https://www.segger.com/downloads/jlink)并在生成配置时选择。

- 导入项目（生成配置）时，如果选择的调试服务器是Segger Jlink，由于Jlink不直接支持`--version`参数，校验表单时需要多等待约3秒的时间。

- 如果之前的构建任务启动失败（例如Makefile构建目录不存在），下次运行会一直弹出等待进度（请重启vscode）。

- 快速连续多次点击状态栏按钮启动构建任务时，如果之前的任务启动失败，任务报告统计可能错乱。

## 问题反馈

前往[github/issues](https://github.com/jswyll/jswyll-vscode-rtthread/issues?utm_source=vsmp&utm_medium=ms%20web&utm_campaign=mpdetails)或联系<jswyll@qq.com>。

如有必要，打开输出面板，把日志等级调到“调试”，复现问题，提供你脱敏处理后的日志。

![images/1735660800031.png](https://oss-club.rt-thread.org/uploads/20250102/d3e0eb1faa93cbe7cb98e64a91cd80b7.png.webp)

## 实现细节

受影响文件的范围：

- 在`.vsocde`下生成相关配置。

- 根据选择的菜单配置，生成配置文件（`.config`）及头文件（`rtconfig_project.h`）。

- 选择RT-Thread Studio构建的方式时，会优化所选构建配置（例如工作区文件夹的`Debug`文件夹）下的makefile。

查看源码：

- 仓库地址：<https://github.com/jswyll/jswyll-vscode-rtthread/>。

- 开发说明：<https://github.com/jswyll/jswyll-vscode-rtthread/tree/main/docs/README.md>。

## 隐私保护指引

本扩展仅处理实现扩展功能所必要的信息，例如读取Env安装目录的Kconfig文件以生成菜单配置界面、查找选择的RT-Thread Studio目录中的GCC编译器以供选择。

为了便于问题定位与排查，本扩展可能会记录相关日志，vscode可能会将最近的一小段日志存储在电脑本地。本扩展的日志等级与输出面板中`jswyll-vscode-rtthread`设置的等级一致（详细程度：“跟踪”>“调试”>“信息”>“警告”>“错误”>“关”，默认为“信息”），请仅在需要向开发者反馈问题时临时提高输出等级。

本扩展不会将你的信息上传到开发者服务器或任何第三方平台。若未来新版本变更了信息的使用目的或范围，将先以弹窗的方式告知并征得你的明示同意。

你可以在生成配置文件后禁用此扩展。如果禁用，将使用不了需要扩展运行的功能（例如状态栏按钮、菜单配置界面、右键菜单）。

wake_mirco 打赏了 5.00 元 2025-04-02 23:49:02
wake_mirco 打赏了 5.00 元 2025-04-09 14:17:44
wake_mirco 打赏了 100.00 元 2025-04-12 13:31:36

33 条评论

bernard 2025-01-04

这家伙很懒，什么也没写！

寻找GUI 2025-01-04

没有最终的成功，也没有致命的失败，可贵的是继续前进的勇气

用户名由3_15位 2025-01-05

代码总在「分分钟搞定」的狂喜与「必有暗坑」的隐忧间往复

聚散无由 2025-01-05

https://jswyll.com

bernard 2025-01-05

这家伙很懒，什么也没写！

EPTmachine 2025-01-06

Big Maker

wx030510226 2025-01-11

这家伙很懒，什么也没写！

聚散无由 2025-01-16

https://jswyll.com

Lu_盼盼 2025-01-20

这家伙很懒，什么也没写！

聚散无由 2025-01-20

https://jswyll.com

聚散无由 2025-01-20

https://jswyll.com

转角遇见狗 2025-02-13

这家伙很懒，什么也没写！

梦笑真美 2025-02-19

这家伙很懒，什么也没写！

静香 2025-03-04

这家伙很懒，什么也没写！

chenyaxing 2025-03-05

泥上偶然留指爪，鸿飞那复计东西。

wangdz 2025-03-09

这家伙很懒，什么也没写！

聚散无由 2025-03-10

https://jswyll.com

codercmd 2025-03-24

这家伙很懒，什么也没写！

聚散无由 2025-03-24

https://jswyll.com

codercmd 2025-03-29

这家伙很懒，什么也没写！

聚散无由 2025-03-30

https://jswyll.com

[@wangdz](https://club.rt-thread.org/u/bae2676bbd9ec155) [@codercmd](https://club.rt-thread.org/u/c343cdf1cb4551ff)

## 问题复现

1. 在RT-Thread Studio构建一次；

2. 使用本插件导入项目，其中GCC编译器选择RT-Thread Studio内置的`env_released/env/tools/gnu_gcc/arm_gcc/mingw/bin/arm-none-eabi-gcc.exe`（默认版本为10.3.1）；

3. 修改代码，在vscode构建，报错：

```
../arm-none-eabi/bin/ld.exe: D:\RT-ThreadStudio\workspace\at32f435vmt7-v4.1.1\Debug/../rt-thread/components/drivers/misc/pin.c:186: undefined reference to `__locale_ctype_ptr'
```

## 原因分析

这是因为先后两次构建的编译器版本不一样，这在操作说明的[开始生成](https://club.rt-thread.org/ask/article/ce74ef49bc11e858.html#%E5%BC%80%E5%A7%8B%E7%94%9F%E6%88%90)里有特别说明的：

> **注意**
>
> 切换编译器版本后（在本扩展的配置面板选择的GCC版本和RT-Thread Studio的不一样，或前后两次在本扩展的配置面板选择GCC版本不一样，先后编译），应重新编译，以消除编译器版本差异引发不可预料的结果。

为什么？因为Makefile是增量编译的，没改动的文件的中间产物`xxx.o`还是RT-Thread Studio的编译器产生的（默认版本是arm-none-eabi-gcc 5.4.1），而导入时选择的编译器的版本默认是10.3.1。那么，将不同版本的中间文件`.o`链接合并成`.elf`就会出问题。

## 解决方案

方案1：如果使用了（或者重新使用了）RT-Thread Studio构建一次项目，再切换到vscode下构建时，先执行一次“清除”任务，再执行“构建”任务。（或者运行“重新构建”任务）。

方案2：在RT-Thread Studio中选中项目，然后在顶部菜单栏 - “项目” - “属性” - “MCU” - “ARM Toolchains Paths”，把使用的编译器也改成和vscode选择的一样的：

![screenshot_image.png](https://oss-club.rt-thread.org/uploads/20250330/73f64f110751024bfea5d45dacbb8ea9.png.webp)

## 后续优化

感谢反馈，下一个版本插件将在使用RT-Thread Studio构建或重新构建后，弹窗提示是否清理构建。

qhsj 2025-03-30

这家伙很懒，什么也没写！

codercmd 2025-03-30

这家伙很懒，什么也没写！

王小明zzZZ 2025-04-08

这家伙很懒，什么也没写！

聚散无由 2025-04-08

https://jswyll.com

T_Grove 2025-04-23

这家伙很懒，什么也没写！

请问这个该如何解决呢(设置的编译链如果是10的那个,studio也会出现这个问题,换到5.4.1就都好了)
*  正在执行任务: cmd.exe /c 'make -j16 all --output-sync=target'

compiling ../rt-thread/src/clock.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/include/rthw.h:20,
                 from ../rt-thread/src/clock.c:19:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/clock.o] Error 1
make: *** Waiting for unfinished jobs....
compiling ../rt-thread/src/components.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/include/rthw.h:20,
                 from ../rt-thread/src/components.c:20:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/components.o] Error 1
compiling ../rt-thread/src/device.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/src/device.c:17:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/device.o] Error 1
compiling ../rt-thread/src/ipc.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/src/ipc.c:42:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/ipc.o] Error 1
compiling ../rt-thread/src/idle.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/include/rthw.h:20,
                 from ../rt-thread/src/idle.c:20:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/idle.o] Error 1
compiling ../rt-thread/libcpu/arm/cortex-m7/context_gcc.S...
compiling ../rt-thread/src/irq.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/include/rthw.h:20,
                 from ../rt-thread/src/irq.c:14:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/irq.o] Error 1
compiling ../rt-thread/src/kservice.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/src/kservice.c:22:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/kservice.o] Error 1
compiling ../rt-thread/src/mem.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/include/rthw.h:20,
                 from ../rt-thread/src/mem.c:50:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/mem.o] Error 1
compiling ../rt-thread/src/mempool.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/include/rthw.h:20,
                 from ../rt-thread/src/mempool.c:19:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/mempool.o] Error 1
compiling ../rt-thread/src/object.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/src/object.c:18:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/object.o] Error 1
compiling ../rt-thread/src/scheduler.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/src/scheduler.c:33:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/scheduler.o] Error 1
compiling ../rt-thread/src/thread.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/include/rthw.h:20,
                 from ../rt-thread/src/thread.c:31:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/thread.o] Error 1
compiling ../rt-thread/src/signal.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/include/rthw.h:20,
                 from ../rt-thread/src/signal.c:16:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/signal.o] Error 1
compiling ../rt-thread/src/timer.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/src/timer.c:21:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/src/subdir.mk:58: rt-thread/src/timer.o] Error 1
compiling ../rt-thread/libcpu/arm/cortex-m7/cpu_cache.c...
In file included from ../rt-thread/include/rtlibc.h:21,
                 from ../rt-thread/include/rtdef.h:1103,
                 from ../rt-thread/include/rtthread.h:24,
                 from ../rt-thread/include/rthw.h:20,
                 from ../rt-thread/libcpu/arm/cortex-m7/cpu_cache.c:12:
../rt-thread/include/libc/libc_signal.h:20:10: fatal error: cconfig.h: No such file or directory
   20 | #include <cconfig.h>
      |          ^~~~~~~~~~~
compilation terminated.
make: *** [rt-thread/libcpu/arm/cortex-m7/subdir.mk:31: rt-thread/libcpu/arm/cortex-m7/cpu_cache.o] Error 1

*  终端进程“C:\Windows\System32\WindowsPowerShell\v1.0\powershell.exe -Command cmd.exe /c 'make -j16 all --output-sync=target'”已终止，退出代码: 1。

sANT 2025-04-24

这家伙很懒，什么也没写！

聚散无由 2025-04-24

https://jswyll.com

九猿521 2025-05-21

这家伙很懒，什么也没写！

九猿521 2025-05-21

这家伙很懒，什么也没写！

九猿521 2025-05-21

这家伙很懒，什么也没写！

```
CC build\kernel\src\timer.o
d:/rt-threadstudio/platform/env_released/env/tools/gnu_gcc/arm_gcc/mingw/bin/../lib/gcc/arm-none-eabi/10.3.1/../../../../arm-none-eabi/bin/ld.exe: d:/rt-threadstudio/platform/env_released/env/tools/gnu_gcc/arm_gcc/mingw/bin/../lib/gcc/arm-none-eabi/10.3.1/../../../../arm-none-eabi/lib\libc.a(lib_a-exit.o): in function `exit':
exit.c:(.text.exit+0x2c): undefined reference to `_exit'
d:/rt-threadstudio/platform/env_released/env/tools/gnu_gcc/arm_gcc/mingw/bin/../lib/gcc/arm-none-eabi/10.3.1/../../../../arm-none-eabi/bin/ld.exe: d:/rt-threadstudio/platform/env_released/env/tools/gnu_gcc/arm_gcc/mingw/bin/../lib/gcc/arm-none-eabi/10.3.1/../../../../arm-none-eabi/lib/crt0.o: in function `_mainCRTStartup':
(.text+0x110): undefined reference to `main'
d:/rt-threadstudio/platform/env_released/env/tools/gnu_gcc/arm_gcc/mingw/bin/../lib/gcc/arm-none-eabi/10.3.1/../../../../arm-none-eabi/bin/ld.exe: C:\Users\ADMINI~1\AppData\Local\Temp\cca8cUdo.o: in function `_update_done':
(.text+0xd8): undefined reference to `rt_hw_hard_fault_exception'
d:/rt-threadstudio/platform/env_released/env/tools/gnu_gcc/arm_gcc/mingw/bin/../lib/gcc/arm-none-eabi/10.3.1/../../../../arm-none-eabi/bin/ld.exe: C:\Users\ADMINI~1\AppData\Local\Temp\cca8cUdo.o: in function `rt_hw_interrupt_check':
(.text+0xec): undefined reference to `rt_thread_switch_interrupt_flag'
d:/rt-threadstudio/platform/env_released/env/tools/gnu_gcc/arm_gcc/mingw/bin/../lib/gcc/arm-none-eabi/10.3.1/../../../../arm-none-eabi/bin/ld.exe: (.text+0xf0): undefined reference to `rt_interrupt_from_thread'
d:/rt-threadstudio/platform/env_released/env/tools/gnu_gcc/arm_gcc/mingw/bin/../lib/gcc/arm-none-eabi/10.3.1/../../../../arm-none-eabi/bin/ld.exe: (.text+0xf4): undefined reference to `rt_interrupt_to_thread'
collect2.exe: error: ld returned 1 exit status
scons: *** [build\kernel\libcpu\arm\cortex-m3\context_gcc.o] Error 1
scons: building terminated because of errors.
```

聚散无由 2025-05-22

https://jswyll.com

[@九猿521](https://club.rt-thread.org/u/3f8ee86240e008d9)

1. 终端进程启动失败可能的原因：

- 尝试直接在终端粘贴`cmd.exe /c "make -j16 all --output-sync=target"`并回车运行，看报错是什么
	
	- vscode终端用了旧的配置接口，参考：<https://blog.csdn.net/qq_18301257/article/details/121327965>。但如果你是新接触的vscode，应该不是这个原因。
	
	- 尝试这个帖子的5种方案：<https://zhuanlan.zhihu.com/p/697608735>
	
	- 尝试切换vscode使用的终端为cmd或powershell 1.0（自带）或[pwsh（powershell 7）](https://learn.microsoft.com/zh-cn/powershell/scripting/install/installing-powershell-on-windows?view=powershell-7.5)
	
	- 尝试切换为使用native版本的cmd：`cmd.exe /c "make -j16 all --output-sync=target"`，参考：<https://www.jianshu.com/p/f15dd9404321>
	
	- 注意到你的用户名`ADMINI~1`包含了特殊符号，而`~`在许多程序中是用来表示用户主目录的，试试以管理员身份运行vscode，然后在vscode中打开项目的主目录，试试能不能运行任务。如果这样能运行，是这个原因那就有点棘手，你的很多程序在vscode都将不能使用，可以参考[重命名用户目录](https://blog.csdn.net/songxunwen/article/details/121175952)或重装系统（注意备份好重要资料）来修改成只包含英文或数字的用户名。
	
2. 编译报错`undefined reference to `rt_thread_switch_interrupt_flag'`可能的原因：

- 使用ConEmu原始方式编译，如果结果相同说明工程不支持scons构建。例如，添加硬件移植文件（`context_gcc.s`、`cpuport.c`）了吗？`startup_xx.s`是GCC环境的吗？
	
	- 上一个原因导致的问题。

论坛消息没法及时收到，可以邮箱或QQ联系我帮你排查：2439423861

二二十四 1天前

这家伙很懒，什么也没写！

studio的工程，导入的时候没问题，在构建的时候报了好多重定义的错误，是arm-none-eabi中的文件和工程中的rt-thread文件夹下的文件基本完全一样，应该如何处理，要删掉哪一边吗

```c
In file included from d:\rt-threadstudio\platform\env_released\env\tools\gnu_gcc\arm_gcc\mingw\arm-none-eabi\include\signal.h:6,
                 from rt-thread\include/libc/libc_signal.h:72,
                 from rt-thread\include/rtlibc.h:21,
                 from rt-thread\include/rtdef.h:1103,
                 from rt-thread\include/rtthread.h:24,
                 from rt-thread\components\drivers\misc\adc.c:12:
d:\rt-threadstudio\platform\env_released\env\tools\gnu_gcc\arm_gcc\mingw\arm-none-eabi\include\sys\signal.h:42:7: error: redefinition of 'union sigval'
   42 | union sigval {
      |       ^~~~~~
In file included from rt-thread\include/rtlibc.h:21,
                 from rt-thread\include/rtdef.h:1103,
                 from rt-thread\include/rtthread.h:24,
                 from rt-thread\components\drivers\misc\adc.c:12:
rt-thread\include/libc/libc_signal.h:28:7: note: originally defined here
   28 | union sigval
      |       ^~~~~~
```