在 macOS 上搭建 STM32 开发环境，推荐以下两种主流方案（均支持中文界面）：

方案一：STM32CubeIDE（官方一体化工具）

特点：官方集成开发环境，包含代码编辑、编译、调试、烧录和图形化配置功能。

1. 下载安装：

   • 访问 ST 官网下载页面
   • 选择 macOS 版本（stm32cubeide-mac_x.x.x.dmg）
   • 双击安装并拖入 Applications 文件夹

2. 环境配置：

   • 首次启动时选择工作空间目录（建议纯英文路径）
   • 安装所需芯片支持库（自动提示下载 HAL/LL 库）

3. 创建项目：

   • 菜单栏 → File → New → STM32 Project
   • 搜索芯片型号（如 STM32F103C8T6）
   • 使用 图形化引脚配置工具（STM32CubeMX 内置）设置时钟和外设
   • 生成代码后直接编写业务逻辑

4. 调试烧录：

   • 连接 ST-Link/V2 调试器到开发板
   • 点击工具栏 Debug 按钮（绿色甲虫图标）自动识别设备

方案二：VS Code + PlatformIO（轻量灵活）

特点：模块化配置，适合喜欢自定义的开发者。

1. 安装依赖：

   # 安装 VS Code（官网下载）
   # 安装 PlatformIO 插件：
   #   VS Code 扩展商店 → 搜索 "PlatformIO IDE" → 安装

2. 创建项目：

   • 打开 VS Code → 点击左侧 PlatformIO 图标（小房子）
   • New Project → 选择开发板型号（如 BluePill F103C8）
   • 框架选择 ST STM32（默认使用 Cube 库）

3. 开发调试：

   • 代码编写：编辑 src/main.c
   • 编译：底部工具栏 ✔️ 图标
   • 烧录：→ 箭头图标
   • 调试：? 图标（需提前配置 platformio.ini 中的调试工具）

4. 关键配置（platformio.ini 示例）：

   [env:bluepill_f103c8]
   platform = ststm32
   board = bluepill_f103c8
   framework = stm32cube
   debug_tool = stlink  # 使用 ST-Link 调试器

必备硬件支持

1. 调试器（二选一）：
   • ST-Link/V2（官方推荐，兼容性好）
   • J-Link（需 macOS 驱动，下载地址）
2. 驱动安装：
   • ST-Link 在 macOS Catalina 及以上通常免驱
   • 若无法识别，尝试安装 ST-Link 驱动

中文支持技巧

1. STM32CubeIDE 汉化：
   • 顶部菜单 Help → Set Language → 简体中文（需重启）
2. VS Code 汉化：
   • 插件市场搜索 Chinese (Simplified) Language Pack 安装

常见问题解决

1. 权限问题（/dev/cu.usbxxx 拒绝访问）：

   sudo chmod 666 /dev/cu.usbmodem*

   （或创建 udev 规则永久解决）

2. 烧录失败：
   • 检查 BOOT0 引脚是否置低（接地）
   • 更换 USB 线或调试器端口

推荐新手使用 STM32CubeIDE，企业开发推荐 VS Code + PlatformIO。两者均提供完善的 STM32 芯片支持，可免费商用。