2、开发环境全家桶安装：STM32CubeMX、CubeIDE、CubeMonitor、X-CUBE-AI扩展包安装与验证
说实话，很多初学者一上来就急着写神经网络代码，结果卡在环境配置上大半天。我见过太多人因为工具链没装对，浪费了一整天。这一章，咱们就把这些工具一次性搞定。
你想想看，STM32CubeAI这套工具链，说白了就是四个核心组件：CubeMX负责图形化配置芯片和外设，CubeIDE是集成开发环境，CubeMonitor用来实时监控数据，X-CUBE-AI则是把训练好的模型转换成能在STM32上跑的代码。缺一个，整个流程就跑不通。
2.1 安装前的准备工作
我个人习惯先把所有安装包下载好，再统一安装。这样省得来回切换页面。你需要准备：
- STM32CubeMX（最新版，我写这章时是6.12.0）
- STM32CubeIDE（建议1.15.0以上）
- STM32CubeMonitor（选装，但强烈建议装）
- X-CUBE-AI扩展包（版本要和CubeMX匹配）
⚠️ 注意： 我曾经遇到过CubeMX和X-CUBE-AI版本不匹配的问题，导致模型转换时直接报错。建议下载前先看官方Release Notes，确认兼容性。
2.2 STM32CubeMX安装
这个最简单。去ST官网下载安装包，双击运行，一路Next就行。嗯，这里要注意：安装路径不要有中文，否则后面生成代码时会出乱码。
安装完成后，第一次启动会让你选择工作空间。我建议单独建一个文件夹，比如D:\STM32Workspace。别偷懒用默认路径，后面项目多了你就知道好处了。
💡 小技巧： 安装完后，记得在Help → Install New Software里检查一下更新。我每次重装系统后都会先做这一步，能避免很多奇奇怪怪的bug。
2.3 STM32CubeIDE安装
CubeIDE其实是个Eclipse定制版，集成了编译器、调试器。安装过程同样简单，但有个坑——它默认会装Java运行环境，如果你的电脑已经有Java了，可能会冲突。
我的建议是：安装前先把旧版Java卸载干净。有一次我偷懒没卸载，结果CubeIDE启动时一直报JVM错误，折腾了半小时才发现是Java版本冲突。
安装完成后，第一次启动会提示你选择工作空间。这里我建议和CubeMX用同一个工作空间，方便管理。
2.4 X-CUBE-AI扩展包安装
这是整个环境里最关键的一步。X-CUBE-AI扩展包不是独立安装的，而是通过CubeMX的软件包管理器来安装。
操作步骤：
- 打开CubeMX，点击菜单栏的Help → Manage embedded software packages
- 在弹出窗口里，找到X-CUBE-AI，勾选你需要的版本
- 点击Install Now，等待下载完成
下载速度可能会很慢，毕竟服务器在国外。我建议你找个网络好的时间段，或者用代理。实在不行，去ST官网手动下载压缩包，然后通过From Local导入。
🔑 验证是否安装成功： 安装完成后，在CubeMX的Pinout & Configuration标签页里，左侧菜单应该能看到Software Packs → X-CUBE-AI的选项。如果看不到，说明没装好。
2.5 CubeMonitor安装与验证
CubeMonitor是个可视化工具，能实时显示神经网络的推理结果。我个人觉得它比串口打印好用多了。
安装同样简单，下载安装包一路Next。装完后打开，界面是这样的：
+----------------------------------+
| CubeMonitor 1.2.0 |
| +------------------------------+ |
| | Dashboard | |
| | - 添加数据源 | |
| | - 配置图表 | |
| | - 启动监控 | |
| +------------------------------+ |
+----------------------------------+
验证方法：随便找个开发板，烧录一个串口打印的程序。CubeMonitor能通过串口或SWD读取数据，如果能看到波形，就说明装好了。
2.6 环境验证：跑一个Hello World
工具都装好了，咱们得验证一下能不能用。我习惯用CubeMX生成一个最简单的工程，然后编译下载。
步骤：
- 打开CubeMX，新建工程，选择你的开发板型号（比如STM32F746G-DISCO）
- 配置一个GPIO输出，比如PC0接LED
- 生成代码，用CubeIDE打开
- 写一个简单的闪烁程序：
while (1)
{
HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_0);
HAL_Delay(500);
}
编译、下载。如果LED能闪烁，说明整个工具链跑通了。
💡 避坑指南： 我第一次用CubeIDE编译时，报了个arm-none-eabi-gcc not found的错误。后来发现是CubeIDE自带的编译器路径没配置对。解决办法：Window → Preferences → MCU Settings，手动指定编译器路径。
2.7 常见问题与解决
| 问题 | 原因 | 解决办法 |
|---|---|---|
| CubeMX启动报错 | Java版本不兼容 | 安装Java 11或17，并配置JAVA_HOME |
| X-CUBE-AI安装失败 | 网络问题或版本冲突 | 手动下载后通过Local导入 |
| CubeIDE编译报错 | 编译器路径错误 | 检查MCU Settings中的工具链路径 |
| CubeMonitor连不上板子 | 串口驱动未安装 | 安装ST-Link驱动或CH340驱动 |
好了，环境装完，验证通过。下一章咱们就开始真正接触神经网络模型了。说实话，环境配置是最枯燥的部分，但也是最不能跳过的。你想想看，如果工具链都没跑通，后面写再多代码也是白搭。
我个人建议你把这一章的操作步骤截图保存，以后重装系统时能省不少时间。嗯，就这样，咱们下一章见。