2. 开发环境搭建：工欲善其事，必先利其器

做嵌入式开发，环境搭建是第一步。这一步要是没走稳，后面全是坑。我见过不少新手，代码写得挺溜，结果卡在编译不过、下载不了这种基础问题上，一查，原来是工具链没配好。

这一章，咱们就把 STM32L4 的开发环境从头捋一遍。我会把每个工具的安装要点、我踩过的坑，都给你说清楚。

2.1 STM32CubeMX：图形化配置利器

STM32CubeMX 是 ST 官方出的图形化配置工具。说白了，就是帮你自动生成初始化代码的。你点点鼠标，选好外设、配好引脚、设好时钟，它就能生成一套完整的 HAL 库工程。

安装步骤：

1. 去 ST 官网下载 STM32CubeMX 安装包（需要注册账号，免费）。
2. 双击安装，一路 Next。注意安装路径不要有中文。
3. 安装完成后，首次启动会提示你安装 Java 运行环境（JRE）。CubeMX 是基于 Java 的，这个必须装。
4. 启动后，在 Help → Manage embedded software packages 里，找到 STM32CubeL4 固件包，下载安装。

2.2 MDK-ARM（Keil）安装与配置

Keil 是 ARM 开发的老牌 IDE，用的人最多。我个人习惯用 Keil，因为它的调试器用起来顺手，而且很多第三方库都默认支持 Keil 工程。

安装要点：

• 从 ARM 官网下载 MDK-ARM 安装包。注意版本，建议用 5.36 或更新的版本，对 Cortex-M4 支持更好。
• 安装时选择默认路径即可，但同样不要有中文。
• 安装完成后，需要注册 License。如果你用的是评估版，有 32KB 代码限制，做点灯实验够用，但做正式项目肯定不行。
• 安装对应芯片的器件包（Device Family Pack）。在 Keil 的 Pack Installer 里，搜索 STM32L4 系列，安装对应的 Pack。

2.3 IAR Embedded Workbench 安装

IAR 的编译器优化做得很好，生成的代码体积小、效率高。如果你做低功耗项目，对代码尺寸有要求，IAR 是个好选择。

安装流程：

1. 从 IAR 官网下载安装包，同样需要注册。
2. 安装时选择 "IAR Embedded Workbench for ARM" 组件。
3. 安装完成后，需要导入 License 文件（.lic）。
4. 在 Tools → Configure Device Descriptions 里，添加 STM32L4 系列器件描述文件。

说实话，IAR 的界面比 Keil 简洁，但快捷键和操作逻辑不太一样。如果你之前用 Keil，刚切到 IAR 会有点不习惯。不过用熟了就好了。

2.4 固件包导入：STM32CubeL4

STM32CubeL4 固件包包含了所有外设的 HAL 驱动、中间件组件、以及大量例程。这是咱们开发的基础库。

导入方式有两种：

我建议你下载最新稳定版。别追最新版，有时候新版本会有一些兼容性问题。我一般用发布超过 3 个月的版本，社区反馈多，坑都填得差不多了。

2.5 第一个点灯工程验证

环境搭好了，咱们得跑个程序验证一下。点灯，就是嵌入式界的 "Hello World"。

操作步骤：

1. 打开 STM32CubeMX，新建工程，选择芯片型号（比如 STM32L476RG）。
2. 在 Pinout & Configuration 页面，找到 PC13 引脚（开发板上的用户 LED 通常接这个脚），设置为 GPIO_Output。
3. 配置时钟：在 Clock Configuration 页面，选择 HSI 作为系统时钟源，设置主频为 80MHz。
4. 生成代码：Project → Generate Code，选择 IDE 为 MDK-ARM V5。
5. 打开生成的 Keil 工程，在 main.c 的 while(1) 循环里添加代码：

HAL_GPIO_TogglePin(GPIOC, GPIO_PIN_13);
HAL_Delay(500);  // 延时 500ms

6. 编译工程，确保无错误无警告。
7. 用 ST-Link 连接开发板，点击 Download 下载程序。
8. 观察开发板上的 LED，应该以 1Hz 的频率闪烁。

2.6 知识结构总览

下面这张图，把本章的核心内容串起来了。你可以把它当作一个检查清单，看看自己哪一步还没做。

2.7 常见问题与避坑

环境搭建过程中，有几个问题特别容易遇到。我列出来，你碰到了可以直接对照排查。

好了，环境搭建就到这里。工具都装好了，工程也能跑了，咱们就可以正式开始 STM32L4 的低功耗开发之旅了。