以下是STM32软件安装的完整中文指南，涵盖常用工具和环境搭建步骤：

一、必需软件清单

二、详细安装步骤

1. 开发环境准备

   • 安装Java运行环境（CubeMX依赖）
   • 下载离线安装包（避免在线安装超时）

2. STM32CubeMX安装

   # 示例：Linux安装命令
   sudo apt-get install ./SetupSTM32CubeMX-6.8.0.linux

   • Win用户双击.exe安装
   • 首次运行自动下载固件库（约1GB，建议科学上网）

3. IDE安装（二选一）

   • Option 1: Keil MDK

     1. 下载Keil MDK安装包
     2. 安装后运行Pack Installer
     3. 搜索对应芯片型号安装DFP包（如STM32F4xx_DFP.2.17.0.pack）

   • Option 2: STM32CubeIDE

     # Linux解压示例
     unzip en.st-stm32cubeide_1.13.0_14519_20221102_1050_amd64.zip_bundle.sh.zip
     sudo ./st-stm32cubeide_*.sh

4. 驱动安装关键步骤

   • 连接ST-Link到电脑
   • 打开设备管理器识别未安装设备
   • 安装USB驱动：
     • ST官方驱动：STSW-LINK009
     • 或使用Zadig工具安装libusb驱动

5. 验证安装

   // 创建LED闪烁示例工程(CubeMX)
   HAL_GPIO_TogglePin(GPIOA, GPIO_PIN_5);
   HAL_Delay(500);

   • 编译后通过IDE烧录到开发板
   • 观察用户LED闪烁状态

三、避坑指南

1. 驱动安装失败

   • 尝试禁用驱动签名（Win10/11）

     bcdedit /set testsigning on

   • 重启后重新安装

2. CubeMX卡在初始化

   • 删除缓存文件夹： C:\Users\用户名\AppData\Roaming\STMicroelectronics

3. 编译空间不足

   • Keil未激活时有32KB限制
   • 临时方案：启用-O1优化等级

4. ST-Link无法识别

   • 升级固件：使用STM32CubeProgrammer的Firmware update功能

四、进阶工具推荐

提示：建议使用ST官方中文社区资源解决问题，新手推荐先使用STM32CubeIDE + CubeMX组合可快速上手开发。开发过程中保持所有软件更新至最新版本以获得最佳兼容性。

通过此指南可完成完整的STM32开发环境搭建，如遇到具体芯片型号相关问题，建议查阅对应Reference Manual(参考手册)进行外设配置。