STLink MacOS 驱动安装（ST-Link V2/V3 权限配置与使用全攻略）

对于在 MacOS 上进行嵌入式开发的工程师来说，STLink MacOS 驱动安装是开启 STM32 开发环境的第一步。与 Windows 系统不同，Mac 系统通常不需要手动安装传统的 .exe 驱动程序，但由于系统安全性限制，往往需要通过特定工具链来识别调试器。本文将手把手教你如何快速配置 STLink，让你的开发板在 Mac 上跑起来。

一、准备工作：安装 Homebrew

在 Mac 上安装任何开发工具，首选都是 Homebrew。如果你还没有安装这个“包管理器神器”，请打开“终端(Terminal)”并输入以下命令。这是完成 Homebrew 安装教程的核心步骤：

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

二、安装 STLink 核心组件

MacOS 识别 STLink 主要依靠 stlink 和 openocd 这两个开源库。它们包含了驱动逻辑和调试协议。在终端输入：

brew install stlink openocd

安装完成后，你可以通过命令 st-info --probe 来检测是否成功识别到 STLink 硬件。

三、串口与 USB 权限配置

在 MacOS Big Sur 及更高版本中，系统对 USB 设备有严格控制。通常情况下，普通的 Mac 串口权限配置 是自动完成的，但如果遇到“Permission Denied”报错，请按以下步骤操作：

确保使用原装或带数据传输功能的 USB 线缆。
如果提示系统拦截，请前往“系统设置 -> 隐私与安全性”，点击“允许”来自 STM 的硬件连接。
对于 V3 系列调试器，可能需要安装 STM32CubeProgrammer 官方软件来自动注入内核扩展。

四、验证连接是否成功

插上你的 STLink 和 STM32 开发板，在终端执行以下指令：

st-flash read dummy.bin 0x08000000 0x10

如果终端输出了设备 ID 和容量信息，说明你的 STLink MacOS 驱动安装 已经圆满完成！现在你可以配合 VS Code、CLion 或 STM32CubeIDE 开始愉快的代码调试了。

小贴士： 如果你的 Mac 是 M1/M2/M3 芯片（Apple Silicon），请确保你的 Homebrew 路径在 /opt/homebrew，并根据提示配置好环境变量，否则可能会找不到 st-link 命令。

STLink MacOS 驱动安装（ST-Link V2/V3 权限配置与使用全攻略）