开发环境准备：硬件平台选择、工具链安装与LVGL源码获取

做嵌入式GUI开发，说白了就是三件事：选一块合适的板子、搭一套趁手的工具、拿到能跑的源码。这三样没准备好，后面写再多代码也是空中楼阁。我这些年带过不少新人，发现很多人一上来就急着写界面，结果编译报错找不到头文件、下载程序连不上调试器……嗯，咱们先把地基打牢。

硬件平台怎么选？STM32还是ESP32

很多朋友会问我：“老师，到底用STM32还是ESP32？”我的回答是——看你项目要什么。这不是和稀泥，是真的各有各的脾气。

软件工具链安装：IDE、编译器、调试器

工具链这东西，说白了就是让电脑能听懂你写的C代码，然后把它变成芯片能跑的机器码。我见过有人装了三天环境还没搞定，其实没那么复杂，一步步来。

IDE选择：Keil vs STM32CubeIDE vs ESP-IDF

• Keil MDK：老牌工具，编译快，调试稳。但收费，而且只支持ARM内核。我早期做项目都用它，后来发现许可证管理太麻烦。
• STM32CubeIDE：ST官方出品，免费，基于Eclipse。集成了CubeMX配置工具，生成初始化代码很方便。我现在做STM32项目基本都用它。
• ESP-IDF + VS Code：乐鑫官方框架，开源免费。用VS Code装插件就能开发，调试用OpenOCD。适合喜欢命令行和插件生态的朋友。

编译器与调试器安装步骤

1. 安装ARM GCC（可选）：如果你用STM32CubeIDE或ESP-IDF，它们自带编译器。如果要用开源工具链，下载ARM GCC工具链，解压到无中文路径的目录。
2. 配置环境变量：把编译器bin目录加到系统PATH里。打开命令行输入arm-none-eabi-gcc --version，能看到版本号就对了。
3. 调试器驱动：
   • ST-Link：安装STM32CubeProgrammer，驱动自动装好。
   • J-Link：去SEGGER官网下载驱动包。
   • USB转串口（ESP32用）：装CH340或CP210x驱动。
4. 验证连接：把开发板连上电脑，打开设备管理器，能看到对应的调试器或串口设备。

LVGL源码获取：从GitHub到本地工程

LVGL的源码托管在GitHub上，获取方式有两种：直接下载ZIP包，或者用Git克隆。我建议用Git，因为后面更新版本、切换分支都方便。

方式一：Git克隆（推荐）

# 克隆主仓库
git clone https://github.com/lvgl/lvgl.git

# 进入目录，切换到稳定版本（比如v8.3.11）
cd lvgl
git checkout v8.3.11

# 克隆依赖的显示驱动和输入驱动（可选）
git clone https://github.com/lvgl/lv_drivers.git
git clone https://github.com/lvgl/lv_port_esp32.git  # 如果是ESP32

方式二：直接下载ZIP

去GitHub的Release页面，找到你想要的版本，下载Source code (zip)。解压后把lvgl文件夹放到你的工程目录里。

工程结构速览

拿到源码后，你的工程目录大概长这样：

my_lvgl_project/
├── lvgl/                    # LVGL核心源码
│   ├── src/                 # 核心库（控件、绘图、事件等）
│   ├── examples/            # 官方示例
│   ├── lv_conf_template.h   # 配置模板（复制并重命名为lv_conf.h）
│   └── lvgl.h               # 主头文件
├── lv_drivers/              # 显示和输入驱动（可选）
├── main.c                   # 你的主程序
├── main.h
└── Makefile / CMakeLists.txt

本章知识体系

下面这张图帮你理清开发环境准备的整个脉络：

常见问题与避坑

• 编译报错“lv_conf.h not found”：检查lv_conf.h是否在工程根目录，或者是否在编译器包含路径里。我习惯在IDE的预定义宏里加一个LV_CONF_PATH来指定路径。
• 下载程序后屏幕不亮：先检查硬件连接——电源、地线、SPI/I2C引脚对不对。然后用逻辑分析仪看波形，比用眼睛瞪靠谱多了。
• LVGL示例跑起来很卡：八成是没开硬件加速，或者帧缓冲区太小。在lv_conf.h里把LV_COLOR_DEPTH改成16，LV_USE_DRAW_SW改成1，先跑通再说优化。

好了，环境准备好之后，下一件事就是让LVGL在你的板子上亮起来。别急，咱们一步一步来。