Mac下使用CLion进行STM32开发详细教程 （从零搭建环境到点亮LED）

Mac下使用CLion进行STM32开发详细教程 （从零搭建环境到点亮LED）

对于嵌入式开发者，在 Mac开发环境 下进行 STM32开发 往往面临工具链繁杂、IDE不兼容等问题。本文将手把手教你使用 CLion教程 级的方法，配合 OpenOCD调试 工具，在macOS上搭建一套完整的STM32开发流水线，即使是小白也能轻松上手。

一、准备工作：安装核心工具链

1. 安装Homebrew

Mac下的包管理神器，打开终端粘贴：

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

2. 安装arm-none-eabi-gcc（ARM交叉编译工具链）

通过brew一键安装：

brew install arm-none-eabi-gcc

3. 安装OpenOCD（片上调试器）

用于烧录和调试：

brew install open-ocd

4. 安装STM32CubeMX

从ST官网下载macOS版本并拖入Applications文件夹。此工具用于图形化配置芯片外设并生成初始化代码。

二、CLion配置与插件安装

CLion是JetBrains出品的跨平台C/C++ IDE，对 CLion嵌入式开发 支持通过插件实现。

• 打开CLion，进入 Preferences → Plugins，搜索“Embedded Development”并安装。
• 重启IDE，在 Build, Execution, Deployment → Toolchains 中点击“+”，选择“Arm GCC”，自动检测工具链路径（通常brew安装位置为 /opt/homebrew/bin）。

三、使用STM32CubeMX生成项目

1. 打开STM32CubeMX，选择你的MCU型号（如STM32F103C8）。
2. 配置时钟、GPIO（例如将PC13设为输出，用于板载LED）。
3. 在 Project Manager 中：
   • 设置项目名称、路径。
   • Toolchain / IDE 选择 Makefile —— CLion通过CMake管理，但CubeMX生成Makefile后稍作转换即可。
   • 勾选“Generate Under Root”使文件结构更简洁。
4. 点击 GENERATE CODE，生成项目文件夹。

四、在CLion中导入并配置CMake

CLion原生支持CMake，我们需要在项目根目录手动创建 CMakeLists.txt，内容如下：

cmake_minimum_required(VERSION 3.15)project(YourProjectName C ASM)set(CMAKE_C_STANDARD 99)set(CMAKE_C_FLAGS "-mcpu=cortex-m3 -mthumb -Wall -ffunction-sections -fdata-sections")set(CMAKE_EXE_LINKER_FLAGS "-mcpu=cortex-m3 -mthumb -Wl,-Map=${CMAKE_PROJECT_NAME}.map -Wl,--gc-sections")# 添加CubeMX生成的源文件file(GLOB_RECURSE SOURCES "Src/.c" "Inc/.h" "Drivers/.c" "Drivers/.h")add_executable(${CMAKE_PROJECT_NAME}.elf ${SOURCES})# 生成hex/bin文件add_custom_command(TARGET ${CMAKE_PROJECT_NAME}.elf POST_BUILD    COMMAND arm-none-eabi-objcopy -O ihex ${CMAKE_PROJECT_NAME}.elf ${CMAKE_PROJECT_NAME}.hex    COMMAND arm-none-eabi-objcopy -O binary ${CMAKE_PROJECT_NAME}.elf ${CMAKE_PROJECT_NAME}.bin    COMMENT "Generating hex and bin files")

然后通过CLion的 Open 直接打开项目根目录，IDE会自动加载CMake配置。

五、配置烧录与调试（OpenOCD）

在CLion中，进入 Run → Edit Configurations，添加 OpenOCD Download & Run 配置：

• Target: 选择你的 .elf 文件。
• Board config file: 根据调试器选择，例如 ST-Link 对应 interface/stlink.cfg，目标芯片如 target/stm32f1x.cfg。
• OpenOCD path: 填写 /opt/homebrew/bin/openocd。

六、编写代码与测试（LED闪烁）

在 Src/main.c 的while循环中添加：

HAL_GPIO_TogglePin(LED_GPIO_Port, LED_Pin);HAL_Delay(500);

点击 锤子图标 编译，然后选择刚才配置的OpenOCD运行按钮，即可烧录并自动运行。若一切顺利，你将看到开发板上的LED以0.5秒间隔闪烁。

七、进阶调试技巧

CLion配合OpenOCD支持断点调试、变量查看。只需在代码行号旁点击设置断点，然后以 Debug 模式运行OpenOCD配置，即可像调试桌面程序一样调试 STM32开发 固件。利用此功能可以极大提高 Mac开发环境 下的问题定位效率。

✅ 至此，你已经在Mac上使用CLion完成了STM32工程的创建、编译、烧录和调试全流程。这套环境不仅免费、跨平台，而且高度可定制，非常适合作为专业 嵌入式开发 的首选方案。

#STM32开发 #Mac开发环境 #CLion教程 #OpenOCD调试 —— 小白友好·专业级教程