Mac 平台使用 CLion 高效开发 STM32：从零搭建现代化嵌入式环境
对于习惯 macOS 环境的开发者，每次为了 STM32 开发切回 Windows 用 Keil，往往面临界面陈旧、调试割裂、跨平台协作麻烦等问题。经过反复验证，CLion + STM32CubeMX + OpenOCD 这个组合不仅完全可行，而且体验出乎意料地好。代码自动补全精准，GDB 调试丝滑，寄存器可视化清晰，还能一键生成初始化代码。
以下记录完整的搭建流程，重点解决常见坑点，确保你少走弯路。
环境准备与工具链安装
整个流程的核心在于打通四个关键组件：
- CLion：提供现代化编辑体验
- STM32CubeMX：图形化配置时钟、外设、引脚
- arm-none-eabi-gcc：交叉编译器，负责把 C 代码编译成 ARM 指令
- OpenOCD：作为 GDB Server，实现程序烧录与在线调试
⚠️ 注意：本文所有操作均基于 macOS Catalina 及以上系统实测有效。路径、命令可能不适用于 Windows 或 Linux。
安装 CLion 并启用嵌入式支持
前往 JetBrains 官网下载最新版 CLion，版本建议不低于 2019.2，否则可能缺少对嵌入式插件的完整支持。
安装后启动，进入 Preferences → Plugins，搜索关键词 Embedded Development，确保已安装并启用。这个插件至关重要——它让 CLion 支持 OpenOCD、GDB 调试会话、外设寄存器视图等功能。没有它，后续的调试环节将寸步难行。
使用 Homebrew 安装 ARM 交叉编译工具链
Mac 下最省事的方式就是通过 Homebrew 安装官方推荐的 GNU Arm Embedded Toolchain：
brew tap ArmMbed/homebrew-formulae
brew install arm-none-eabi-gcc
安装完成后验证是否成功：
arm-none-eabi-gcc --version
正常输出应类似：
arm-none-eabi-gcc (GNU Tools for Arm Embedded Processors) 10.2.1 ...
如果提示命令未找到，请检查你的 shell PATH 是否包含 /usr/local/bin，或者尝试重启终端。
安装 OpenOCD：连接 PC 与芯片的桥梁
OpenOCD 是整个调试链的核心。它负责通过 ST-Link 等调试器与目标板通信，接收 GDB 指令并执行烧录、断点、单步等操作。
继续使用 Homebrew 安装：
brew install open-ocd
验证版本：
openocd --version
输出示例如下即表示成功：
Open On-Chip Debugger 0.11.0
后续若遇到无法识别调试器的问题，可以手动测试 OpenOCD 是否能探测到设备：
openocd -f interface/stlink-v2.cfg -f target/stm32f1x.cfg
