LVGL 入门（一）：环境搭建与源码获取

目录

• 一、前言
• [二、LVGL 核心介绍](#二、LVGL 核心介绍)
• [三、资源获取：Git 安装与仓库克隆](#三、资源获取：Git 安装与仓库克隆)
• [四、Code::Blocks 安装与配置](#四、Code::Blocks 安装与配置)
• [五、LVGL 案例编译运行](#五、LVGL 案例编译运行)
• [六、工程存放与 LVGL 库源码获取](#六、工程存放与 LVGL 库源码获取)
• 七、总结
• 八、结尾

一、前言

LVGL 作为嵌入式领域主流的开源图形库，凭借轻量、跨平台、易扩展的特性，成为嵌入式 GUI 开发的首选工具。本次笔记作为 LVGL 入门第一篇，聚焦基础环境搭建核心环节，从 LVGL 库的核心特性介绍，到 Git 安装配置、Code::Blocks 环境调试，再到 LVGL 源码获取与案例编译运行，完整梳理 LVGL 入门的前置准备工作，为后续 GUI 开发打下基础。

二、LVGL 核心介绍

LVGL 是一个开源的嵌入式图形库，于 2016 年创建的开源项目（遵循 MIT 协议）。目前由来自世界各地的 400 多名志愿者共同维护和开发，现已成为最流行的免费开源嵌入式图形库。

LVGL 具有轻量级、多功能、灵活和可移植等特点，能帮助开发者快速便捷地创建美观且功能丰富的 GUI。它适用于多种嵌入式平台和显示器，且支持多种操作系统。其名称源自 Light and Versatile Graphics Library，即 "轻便且多功能的图形库"。

三、资源获取：Git 安装与仓库克隆

1. Git 安装

Git 是免费开源的分布式版本控制系统，可快速高效地处理各类规模的项目代码管理，是实际项目开发中必备的工具，掌握 Git 对后续学习和工作至关重要。

• Windows 系统 Git 下载地址：https://git-scm.com/download/win

Git 的核心逻辑与百度云盘类似，但更灵活：从 Git 仓库 clone 代码无下载限速，还可通过密钥发起 PR（Pull Request），仓库所有者可通过 PR 修改文件；而百度云盘仅文件所有者可修改内容。

安装完成后，在任意文件夹右键选择 "Open Git Bash here" 打开 Git 命令行工具：

注意：Git Bash 中粘贴内容不能使用快捷键，只能通过右键选择 "粘贴" 操作。

2. Git 配置与仓库克隆

首先配置 Git 用户名和邮箱（无 Git 账户也可按如下设置）：

# 配置全局Git用户名（示例为Hello_Embed，可替换为自己的名称）
git config --global user.name "Hello_Embed"
# 配置全局Git邮箱（需替换为自己的邮箱地址）
git config --global user.email "这里是你的邮箱"

执行以下命令克隆百问网 LVGL 学习仓库：

git clone https://gitee.com/weidongshan/lvgl_100ask_course_v9.git

若需拉取仓库最新更新，先进入仓库目录再执行拉取命令：

# 进入lvgl_100ask_course_v9目录
cd lvgl_100ask_course_v9/
# 从master分支拉取最新代码
git pull origin master

克隆 / 拉取完成后，在该目录下即可看到百问网提供的 LVGL 学习资料，后续将基于这些资料展开学习。

四、Code::Blocks 安装与配置

1. 软件安装

从以下路径解压并安装 Code::Blocks 软件：

lvgl_100ask_course_v9\part1\03_tools\codeblocks-20.03mingw-setup.zip

2. 软件配置（避免编译报错）

安装完成后，按以下步骤修改软件设置，确保后续编译无异常：

1. 打开 Code::Blocks，点击顶部菜单栏「Settings」，选择第三个选项；

2. 在弹出的窗口中点击「Other settings」；

3. 进入「高级选项」；

4. 取消默认勾选的相关选项，勾选「Use flat objects」；

5. 点击「OK」保存高级选项，返回上一级窗口后再次点击「OK」完成配置。

五、LVGL 案例编译运行

配置完成后，编译运行 LVGL 示例工程，工程路径如下：

lvgl_100ask_course_v9\part1\02_codes\lv_sim_codeblocks_win

编译运行后效果如下：

注意：此处 Code::Blocks 仅作为编译运行工具，后续将使用 VSCode 作为主力 IDE 进行代码编写。

六、工程存放与 LVGL 库源码获取

1. 工程存放规范

已通过 Git 获取百问网学习资料文件夹lvgl_100ask_course_v9，建议新建专属文件夹存放该资料，方便后续学习、修改，且可随时通过git pull命令获取仓库最新更新。

2. LVGL 库源码获取

LVGL 为开源项目，可从官方 GitHub 仓库获取源码，地址：https://github.com/lvgl/lvgl

获取步骤：

1. 打开仓库页面，点击「Releases」按钮；
2. 进入 Release 页面后，选择对应版本（本次使用 9.1.0 版本），点击下载源码压缩包（zip 和 tar.gz 格式内容一致，仅压缩格式不同）。

补充：学习资料包中已预置 LVGL Code::Block 工程源码，可直接使用（课程配套工程）。若需从 LVGL 官方仓库手动搭建该工程，可按以下步骤操作：

1. 打开 LVGL Code::Block 工程源码仓库：https://github.com/lvgl/lv_port_win_codeblocks；

2. 源码获取方式：

   • 方式 1：查看仓库 README 文档，按文档指引操作；
   • 方式 2：打开仓库后选择对应分支，下载版本压缩包，解压后发现 lvgl 文件夹为空，需下载对应版本的 LVGL 源码压缩包，将内容解压到该工程的 lvgl 目录下。

LVGL 官方文档地址：https://docs.lvgl.io/9.1/

七、总结

1. LVGL 是轻量、跨平台的嵌入式开源图形库，是嵌入式 GUI 开发的核心工具；
2. Git 是代码管理必备工具，需掌握安装、配置、克隆 / 拉取仓库的基础操作；
3. Code::Blocks 需完成特定配置避免编译报错，仅作为 LVGL 案例的编译运行工具；
4. LVGL 源码可从官方仓库获取，学习资料包中已预置可直接使用的工程。

八、结尾

本次完成了 LVGL 入门的核心环境搭建，包括 Git 配置、Code::Blocks 调试、源码获取与案例运行，为后续 LVGL 图形界面开发筑牢基础。掌握这些前置准备工作，能让后续的 GUI 开发更高效、顺畅。我是 Hello_Embed，期待你的关注，后续将持续分享 LVGL 的进阶开发技巧！