Mac下使用CLion进行STM32开发：小白必备的高效嵌入式开发环境配置教程（CLion + STM32CubeMX + OpenOCD）

在Mac上进行嵌入式开发，不再需要忍受Keil那过时的界面。通过强大的 CLion 配合 STM32CubeMX，我们可以搭建出一套现代、美观且高效的开发环境。本教程将手把手带你完成 Mac STM32开发 环境的配置。

一、 核心关键词准备

为了方便后续学习，本教程围绕以下核心内容展开：

• Mac STM32开发：在macOS系统下进行ARM架构单片机开发。
• CLion STM32教程：利用JetBrains强大的IDE进行代码编写与工程管理。
• STM32CubeMX配置：生成底层驱动代码及初始化工程。
• OpenOCD烧录调试：连接调试器（如ST-Link或DAP-Link）进行程序下载。

二、 基础环境安装（Homebrew必备）

首先，你需要安装Mac下的包管理器 Homebrew。打开终端，执行以下步骤安装必要的交叉编译工具链：

# 安装ARM交叉编译工具链brew install --cask gcc-arm-embedded# 安装烧录工具 OpenOCDbrew install openocd# 安装构建工具 CMakebrew install cmake

三、 安装软件工具

1. STM32CubeMX：前往ST官网下载Mac版，用于生成初始化配置。
2. CLion：下载并安装最新版 CLion。

四、 CLion 内部环境关联

打开 CLion，进入 Settings (Cmd + ,) 进行如下设置：

• 🛠️ Toolchains：CLion通常会自动识别到 /usr/local/bin/cmake 和 arm-none-eabi-gcc。如果没有，请手动指定路径。
• 🛠️ Embedded Development：在 "STM32CubeMX EXE" 处选择你安装的 STM32CubeMX 应用程序路径（通常在 /Applications 目录下）。
• 🛠️ OpenOCD Location：指定 OpenOCD 的路径（可通过 which openocd 命令查看，通常在 /usr/local/bin/openocd）。

五、 创建你的第一个工程

1. 在 CLion 中新建项目，选择 STM32CubeMX 类型。
2. 点击 "Open with STM32CubeMX" 按钮，开始配置 MCU（如配置时钟、GPIO、串口等）。
3. 关键步骤：在 Project Manager 面板中，将 "Toolchain / IDE" 设置为 STM32CubeIDE（CLion 可以兼容此格式的 .ioc 文件）。
4. 点击 "GENERATE CODE" 生成代码，回到 CLion。

六、 配置文件与烧录

回到 CLion 后，系统会提示你选择面板配置文件（Board Config File）。这是 OpenOCD烧录调试 的核心：

如果是 STM32F103 系列，可以搜索并选择 st_nucleo_f103rb.cfg 或者自定义一个 stm32f103.cfg。配置文件决定了调试器如何通过 SWD/JTAG 与芯片通信。

最后，点击右上角的 "Build" 图标进行编译，点击 "Download" 图标（绿色小箭头）即可通过 OpenOCD 将程序烧录进单片机。

七、 总结

通过本文的 CLion STM32教程，你已经掌握了在 Mac 上搭建专业开发环境的方法。告别虚拟机和繁琐的 Windows 系统，利用 Mac 优秀的高清屏和 CLion 流畅的代码补全，享受更纯粹的 Mac STM32开发 体验吧！如果在 STM32CubeMX配置 过程中遇到驱动识别问题，请检查你的数据线是否具备数据传输功能。