2. 开发环境搭建：安装STM32CubeMX、STM32CubeIDE、X-CUBE-AI扩展包
说实话，环境搭建这一步看着简单，但我在带项目时见过太多人在这里卡壳。有的是版本不匹配，有的是路径带中文，还有的是漏装了某个依赖。所以这一章，咱们把每一步都走踏实。
你想想看，后面所有模型部署、调试、优化的工作，都依赖这套环境。地基没打好，后面全是坑。我个人的习惯是：先列清单，再动手装，装完立刻验证。
2.1 你需要下载哪些东西？
先看一张总览图，搞清楚这几个工具之间的关系：
说白了，CubeMX 负责「画板子配置」，CubeIDE 负责「写代码编译」，X-CUBE-AI 负责「把模型塞进 MCU」。三个工具各司其职，缺一不可。
| 工具/包 | 版本建议 | 主要作用 |
|---|---|---|
| STM32CubeMX | ≥ 6.8.0 | 引脚分配、时钟树、外设配置、生成初始化代码 |
| STM32CubeIDE | ≥ 1.13.0 | 集成开发环境，编译、下载、调试一条龙 |
| X-CUBE-AI | ≥ 8.1.0 | 模型导入、量化、验证、生成 C 代码 |
⚠ 版本兼容性警告： 我曾经遇到过 CubeMX 6.7 和 X-CUBE-AI 7.0 搭配时，模型验证阶段直接崩溃。后来查了 ST 官方 Release Notes，才发现是已知 bug。所以我的建议是：全部用最新稳定版，或者至少保证大版本号一致。
2.2 安装步骤详解
2.2.1 安装 STM32CubeMX
这个最简单。去 ST 官网下载安装包，Windows 用户选 .exe，Linux 用户选 .setup。嗯，这里要注意：
- 安装路径不要有中文。我见过有人装在「D:\软件\STM32」下面，结果生成代码时报路径编码错误。
- Java 环境：CubeMX 依赖 Java Runtime。如果电脑没装 Java，安装程序会自动帮你装。但我建议手动装 JDK 17，更稳定。
- 安装完成后，双击桌面图标，能正常打开界面就算成功。
💡 我的小技巧： 第一次打开 CubeMX 时，它会联网下载一些库包。如果网络慢，可以先去 ST 官网把对应 MCU 的固件包（如 STM32F4xx_FW_Package）手动下载，放到 CubeMX 的 Repository 目录下。这样能省不少时间。
2.2.2 安装 STM32CubeIDE
CubeIDE 是基于 Eclipse 的，所以安装包比较大（约 1.5GB）。下载时注意选对操作系统版本。
- 安装过程基本是「下一步 → 下一步 → 完成」。但有个选项要注意：是否安装驱动。如果你用的是 ST-Link 调试器，一定要勾上。
- 安装完成后，第一次启动会要求选择工作空间（Workspace）。我习惯把工作空间放在项目目录的同级，方便管理。
- 验证方法：新建一个空工程，编译一下，看控制台输出 "Build Finished" 就算 OK。
⚠ 避坑指南： 我曾经在 Windows 上装完 CubeIDE 后，发现 ST-Link 无法识别。折腾了半天，最后发现是驱动没装全。解决办法：去 ST 官网下载 ST-Link 驱动包 手动安装。如果你用的是 V2 或 V3 版本的 ST-Link，驱动不通用，别搞混了。
2.2.3 安装 X-CUBE-AI 扩展包
这个稍微有点讲究。X-CUBE-AI 有两种安装方式：
- 通过 CubeMX 在线安装：打开 CubeMX → Help → Manage Embedded Software Packages → 搜索 "X-CUBE-AI" → 选择版本 → Install。这是最推荐的方式，因为 CubeMX 会自动处理依赖。
- 手动下载安装：去 ST 官网下载 .pack 文件，然后在 CubeMX 中通过 File → Import 导入。适合网络不好的情况。
安装完成后，在 CubeMX 的 Pinout 视图中，你会看到多了一个 "Software Packs" 选项卡。点进去，如果能看到 X-CUBE-AI 的选项，就说明装成功了。
📌 关键点： X-CUBE-AI 不是独立运行的软件，它是 CubeMX 的一个扩展插件。所以它的安装、配置、使用，全部在 CubeMX 内部完成。你不需要单独打开它。
2.3 配置第一个 CubeMX 项目
工具装完了，咱们来实战一把。创建一个最简单的工程，验证整个工具链是否打通。
2.3.1 新建工程
- 打开 CubeMX，点击 "New Project"。
- 在 Board Selector 中搜索你的开发板。我用的是 NUCLEO-F767ZI，你也可以选自己手头的板子。
- 双击选中，CubeMX 会自动加载对应的固件包和默认配置。
2.3.2 配置时钟和调试接口
这一步很多人会忽略，但恰恰是最容易出问题的。
- 调试接口：在 Pinout 视图中，找到 SYS → Debug，选择 "Serial Wire"。如果不选，下载器可能连不上芯片。
- 时钟树：切换到 Clock Configuration 选项卡。我一般直接选 "HSE + PLL"，把主频拉到芯片最高频率。比如 F767 是 216MHz。
💡 经验之谈： 如果你不确定时钟怎么配，可以用 CubeMX 的 "自动解决" 功能。点一下 "Resolve Clock" 按钮，它会自动帮你算出最优配置。但记得检查一下 HCLK、APB1、APB2 的时钟是否在合理范围内。
2.3.3 使能 X-CUBE-AI
- 在 Pinout 视图右侧，找到 "Software Packs" → "Select Components"。
- 勾选 X-CUBE-AI，版本选你刚才安装的那个。
- 在 "Configuration" 中，你会看到 AI 相关的设置项。暂时保持默认，后面章节会详细讲。
2.3.4 生成代码
点击 "GENERATE CODE"，选择 "STM32CubeIDE" 作为目标 IDE。CubeMX 会生成一个完整的工程，包含所有初始化代码和 X-CUBE-AI 的库文件。
生成完成后，用 CubeIDE 打开这个工程。编译一下，如果没有任何错误，恭喜你——环境搭建成功了！
| 步骤 | 操作 | 常见问题 |
|---|---|---|
| 1 | 新建工程，选择板子 | 固件包未下载 → 手动下载或换网络 |
| 2 | 配置调试接口为 Serial Wire | 忘记配置 → 下载器无法连接 |
| 3 | 配置时钟树 | 时钟超频 → 芯片跑飞或不稳定 |
| 4 | 使能 X-CUBE-AI 组件 | 版本不匹配 → 检查兼容性 |
| 5 | 生成代码并编译 | 路径含中文 → 重装到纯英文路径 |
📌 总结一下： 环境搭建的核心就三件事——装对工具、配对版本、走通流程。别贪快，每一步做完都验证一下。后面模型部署的时候，你会发现今天花的时间，全都能省回来。