Mac 虚拟机搭建 Keil5 STM32 开发环境及 ST-Link 驱动问题排查

概述

Keil uVision5 是 Windows 独占的嵌入式开发工具，Mac 系统无原生支持。本文介绍通过安装 Windows 虚拟机来搭建 Keil5 + STM32 开发环境的完整流程，并解决 ST-Link USB Command Error 等常见报错。

准备工具

1. 虚拟机软件：推荐 Parallels Desktop 或 VMware Fusion。
2. Windows 镜像：建议 Windows 10 专业版（从微软官网下载）。
3. Keil 安装包：获取 Keil MDK 官方或授权安装包。
4. ST-Link 调试器：硬件调试必备。

步骤 1：安装 Windows 虚拟机

以 Parallels Desktop 为例：

1. 打开软件，选择「安装 Windows 或其他操作系统」。
2. 选择「从安装镜像文件安装」，加载 Win10 ISO 文件。
3. 按向导配置：
   • 名称：自定义（如 Win10_Keil）
   • 资源：内存 ≥4GB、CPU ≥2 核、硬盘 ≥60GB
4. 安装完成后，务必安装虚拟机增强工具以提升性能。

步骤 2：下载并解压 Keil 安装包

1. 在虚拟机中下载 Keil 压缩包。
2. 解压至非中文路径（例如 D:\KeilSetup）。
3. 主要文件说明：
   • mdk514.exe：主程序
   • Keil.STM32F1xx_DFP.2.2.0.pack：STM32F1 支持包
   • 其他组件按需安装

步骤 3：安装 Keil uVision5

1. 双击 mdk514.exe 启动安装。
2. 勾选协议同意条款，点击 Next。
3. 安装路径建议使用默认 C:\Keil_v5，避免中文路径。
4. 填写用户信息，组件保持默认（ARM 开发环境已勾选）。
5. 等待安装完成，Pack Installer 窗口可稍后处理。

步骤 4：安装 STM32 芯片支持包

1. 运行解压后的 .pack 文件。
2. 确认 Keil 安装路径为 C:\Keil_v5。
3. 点击 Next 完成安装。

步骤 5：激活 Keil uVision5

1. 启动 Keil，点击菜单栏 File → License Management。
2. 复制 CID 栏字符串。
3. 使用授权工具生成 License ID Code。
4. 将生成的代码粘贴到 Keil 激活窗口，点击 Add LIC。
5. 提示 License added successfully 即表示激活成功。

步骤 6：ST-Link 驱动与调试配置

若遇到 ST-Link 无法识别或报错，请按以下步骤操作：

1. 安装 ST-Link 驱动

• 优先尝试在设备管理器中更新驱动，而非 Keil 目录下的驱动。
• 若安装失败，需关闭 Windows 驱动强制签名：
  • 设置 → 更新和安全 → 恢复 → 高级启动 → 疑难解答 → 高级选项 → 启动设置 → 重启 → 按 7 禁用驱动强制签名。

2. 配置 Keil 调试器

1. 新建工程，连接 ST-Link。
2. 点击「魔法棒」图标（Options for Target）。
3. 切换至 Debug 选项卡，选择 ST-Link Debugger。
4. 点击 Settings，确认 Port 为 SW 模式。
5. 点击 Connect，若能读取芯片信息则配置成功。

常见问题排查

1. ST-Link 驱动掉线：Mac 切换 USB 口可能导致驱动丢失。需在设备管理器中重新安装驱动，或重启虚拟机。
2. Keil 激活失败：检查杀毒软件是否拦截，确保以管理员身份运行激活工具。
3. ST-Link 识别失败：检查 USB 线连接、更换端口，或重新安装驱动。
4. 编译报错找不到头文件：确保工程路径不含中文，且芯片支持包已正确安装。
5. 虚拟机无法识别 USB：在虚拟机设置中分配 USB 权限给 Windows 系统。

总结

通过虚拟机在 Mac 上搭建 Keil5 + STM32 环境是稳定方案。按上述步骤操作可解决大部分环境配置及 ST-Link 识别问题。如遇异常，优先检查驱动签名与 USB 权限分配。