本文基于 NUCLEO-C542RC（主控 STM32C542RC）开发板，分享使用 VS Code + STM32CubeMX2 从零搭建环境、配置工程、编写代码，最终点亮板载用户 LED（PA5）的完整开发过程，并总结第一次使用 VS Code 做嵌入式开发的注意事项。

一、开发对象：NUCLEO-C542RC 与板载 LED

1.1 NUCLEO-C542RC 是 ST 意法半导体推出的 Nucleo-64 开发板，属于 STM32C5 新一代主流系列，核心特点如下：

1.2 主控 STM32C542RC：Arm Cortex-M33 内核，144 MHz，593 CoreMark，256 KB 双 Bank Flash（带 ECC）、64 KB SRAM（带 ECC）

1.3 外设丰富：8 KB ICACHE、加解密单元（HASH/SHA/TRNG）、CORDIC、USB FS、双 FDCAN、I3C、12 位 ADC 等

1.4 板载 STLINK-V3EC 调试/编程器：一根 USB Type-C 线即可完成供电、烧录、调试和虚拟串口，无需外接调试器

1.5 板载用户 LED（绿色，丝印 LD1）接 PA5，经 NMOS 管（SB8→R10→Q1）驱动，PA5 输出高电平时点亮

二、开发环境准备（工具清单）

2.1 先安装好以下工具，再开始建工程：

2.2 VS Code：官方最新稳定版。

2.3 STM32CubeMX2：STM32C5 系列的专用配置工具。注意：经典版 STM32CubeMX 不支持 STM32C5，从 STM32C5 起的新系列仅支持 STM32CubeMX2（基于 HAL 2.0）。

2.4 STM32Cube for Visual Studio Code 扩展（ST 官方扩展包，即 STM32CubeIDE for VS Code 方案）：负责工程识别、构建（CMake/Ninja）、烧录与调试。

2.5 命令行工具链：arm-none-eabi-gcc、CMake、Ninja、OpenOCD、STM32CubeProgrammer CLI 等。可通过扩展自带的 Bundle Manager 自动下载，也可手动安装 STM32CubeCLT 工具集。

2.6 USB 驱动：Windows 下安装 ST-LINK 驱动（STSW-LINK009）；Linux 下配置 udev 规则或放开 USB 设备权限。

三、STM32CubeMX2 配置过程（文字描述）

3.1 新建工程：打开 STM32CubeMX2 → New Project，选择按 MCU 新建，搜索 STM32C542RC，选中 LQFP64 封装的 STM32C542RCT6（也可在板卡列表直接选 NUCLEO-C542RC 快速生成）。

3.2 引脚配置：在 Pinout 视图中点击 PA5，选择 GPIO_Output；下方 GPIO 参数保持默认即可（推挽输出 Push-Pull、无上下拉 No pull）。

3.3 时钟配置：点亮 LED 用默认时钟（HSI 16 MHz）即可；需要满速运行时，可在 Clock Configuration 中把 HCLK 配置到 144 MHz（用板载 8 MHz HSE 晶振 + PLL）。

3.4 工程设置（Project Manager）：Project Name 填写 LED_PA5；Toolchain/IDE 选择 CMake（对应 STM32CubeIDE / STM32CubeIDE for VS Code）；推荐勾选“按外设生成独立 .c/.h 初始化文件”（Generate peripheral initialization as a pair of '.c/.h' files per peripheral）。

3.5 生成代码：点击 GENERATE CODE，生成包含 CMakeLists.txt、Core/Src/main.c 等文件的工程目录。

四、在 VS Code 中打开工程并完成首次编译

4.1 VS Code → File → Open Folder，选择 CubeMX2 生成的工程目录（含 CMakeLists.txt 的那一层）。

4.2 首次打开会弹出信任提示，选择 Yes, I trust the authors。

4.3 等待 STM32Cube 扩展自动识别工程；如提示缺少 CLI 工具，按 Bundle Manager 提示下载安装。

4.4 在底部状态栏选择构建器（Ninja 或 Make），点击 Build；或按 Ctrl+Shift+P 执行 CMake: Build。

4.5 首次构建需要编译 HAL 库，约几十秒；成功后 build 目录下生成 LED_PA5.elf。

五、编写点亮 LED 的代码

5.1 打开 Core/Src/main.c，自定义代码必须写在 USER CODE 注释区间内，重新生成代码时才会被保留。

5.2 方案一：常亮（在 USER CODE BEGIN 2 区域写入）：

六、编译、烧录与运行

6.1 修改代码后重新 Build，生成新的 .elf 文件。

6.2 用 USB Type-C 线连接开发板（STLINK-V3EC 的 USB 口），确认板载 PWR ON（LD7）绿灯常亮。

6.3 烧录方式三选一：

6.4 VS Code 扩展：点击扩展面板的 Flash 按钮，或在 Run and Debug 视图直接启动调试，工具会自动识别 ST-LINK 并烧录；

七、经验小结

7.1 STM32C5 是全新系列，配置工具必须使用 STM32CubeMX2（HAL 2.0），旧版 STM32CubeMX 不支持。

7.2 官方推荐的 VS Code 路线：STM32Cube for VS Code 扩展 + CMake 工程，编译、烧录、调试一体化，体验接近 STM32CubeIDE。

7.3 板载 STLINK-V3EC，一根 USB Type-C 线即可供电、下载、串口，非常适合入门。

7.4 点亮 LED 前先查原理图确认电平极性：本板 PA5 经 NMOS 驱动，高电平点亮。

7.5 养成“用户代码只写 USER CODE 区间”的习惯，后续调整外设重新生成代码时业务逻辑才不会丢失。