EDK II开发环境搭建：VS Code+Docker容器化配置指南

【免费下载链接】edk2 EDK II 【免费下载链接】edk2 项目地址: https://gitcode.com/gh_mirrors/ed/edk2

引言：告别环境配置的"坑"

你是否还在为EDK II（EFI开发工具包第二代）开发环境配置而头疼？不同操作系统间的编译工具链差异、依赖库版本冲突、多平台开发环境不一致等问题，常常消耗开发者大量时间。本文将介绍一种基于VS Code和Docker的容器化解决方案，通过"一次配置，到处运行"的方式，让你在15分钟内完成EDK II开发环境的标准化部署，专注于固件代码开发而非环境调试。

读完本文后，你将获得：

  • 一套跨平台（Windows/macOS/Linux）的EDK II容器化开发环境
  • VS Code与Docker容器的无缝集成方案
  • 支持x86_64、AArch64等多架构编译的工具链配置
  • 包含调试、代码分析功能的完整开发流程
  • 可复用的环境配置脚本和Dockerfile

EDK II开发环境痛点分析

EDK II作为UEFI（统一可扩展固件接口）开发的事实标准，其环境配置存在诸多挑战：

痛点传统解决方案容器化解决方案
操作系统兼容性在不同OS上重复配置统一Docker镜像，一次构建多平台运行
工具链版本冲突手动管理多个编译器版本容器内隔离的工具链环境
依赖库缺失逐个安装缺失依赖预打包完整依赖的Docker镜像
开发环境不一致文档记录配置步骤可版本化的Dockerfile配置
多架构支持安装交叉编译工具容器内集成多架构编译工具链

技术架构：容器化开发环境设计

整体架构

mermaid

核心组件说明

  1. Docker容器：基于Ubuntu 24.04构建，包含完整的EDK II编译工具链和依赖库
  2. VS Code：通过Remote - Containers插件连接Docker容器，提供代码编辑、调试功能
  3. EDK II源码：从Git仓库拉取的最新代码，包含OvmfPkg、ArmVirtPkg等常用包
  4. 多架构工具链：支持x86_64、AArch64架构的GCC交叉编译工具
  5. QEMU模拟器：用于测试编译生成的UEFI固件镜像

环境搭建步骤

前置条件准备

在开始前，请确保你的系统已安装以下软件：

# 验证Docker安装
docker --version
docker-compose --version

# 验证VS Code插件安装
code --list-extensions | grep ms-vscode-remote.remote-containers
code --list-extensions | grep ms-vscode.cpptools

步骤1：获取EDK II源码

# 克隆EDK II仓库
git clone https://gitcode.com/gh_mirrors/ed/edk2.git
cd edk2

# 初始化子模块
git submodule update --init

步骤2：创建Docker开发环境

Dockerfile编写

在EDK II源码根目录创建Dockerfile：

FROM ubuntu:24.04

# 设置环境变量
ENV DEBIAN_FRONTEND=noninteractive
ENV WORKSPACE=/edk2
ENV EDK_TOOLS_PATH=$WORKSPACE/BaseTools

# 安装依赖包
RUN apt-get update && apt-get install -y \
    build-essential \
    git \
    python3 \
    python3-pip \
    uuid-dev \
    iasl \
    nasm \
    gcc-aarch64-linux-gnu \
    g++-aarch64-linux-gnu \
    qemu-system-x86 \
    qemu-system-arm \
    && rm -rf /var/lib/apt/lists/*

# 安装Python依赖
COPY pip-requirements.txt $WORKSPACE/
RUN pip3 install --no-cache-dir -r $WORKSPACE/pip-requirements.txt

# 设置工作目录
WORKDIR $WORKSPACE

# 编译BaseTools
RUN make -C BaseTools

# 配置环境变量
RUN echo ". $WORKSPACE/edksetup.sh" >> ~/.bashrc

# 暴露QEMU端口
EXPOSE 5900 22

# 默认命令
CMD ["/bin/bash"]
VS Code配置文件

创建.devcontainer/devcontainer.json：

{
    "name": "EDK II Development Environment",
    "build": {
        "context": "..",
        "dockerfile": "../Dockerfile"
    },
    "settings": {
        "terminal.integrated.shell.linux": "/bin/bash",
        "C_Cpp.default.compilerPath": "/usr/bin/gcc",
        "C_Cpp.default.includePath": [
            "${workspaceFolder}/MdePkg/Include",
            "${workspaceFolder}/MdePkg/Include/X64",
            "${workspaceFolder}/MdeModulePkg/Include",
            "${workspaceFolder}/BaseTools/Include"
        ],
        "files.exclude": {
            "**/.git": true,
            "**/.svn": true,
            "**/.hg": true,
            "**/CVS": true,
            "**/.DS_Store": true
        }
    },
    "extensions": [
        "ms-vscode.cpptools",
        "ms-vscode.makefile-tools",
        "editorconfig.editorconfig",
        "streetsidesoftware.code-spell-checker"
    ],
    "forwardPorts": [5900],
    "mounts": [
        "source=${localWorkspaceFolder},target=/edk2,type=bind"
    ],
    "remoteUser": "root"
}

步骤3：启动容器化开发环境

  1. 在VS Code中打开EDK II源码目录
  2. 当提示"是否在容器中重新打开"时，选择"Reopen in Container"
  3. 首次启动会构建Docker镜像，需要等待10-15分钟
  4. 构建完成后，VS Code会自动连接到容器内的开发环境

步骤4：验证环境配置

在VS Code终端中执行以下命令验证环境：

# 检查工作空间配置
echo $WORKSPACE

# 检查EDK II工具版本
build -h

# 检查Python依赖
python3 --version
pip3 list | grep edk2-pytool

# 检查GCC版本
gcc --version
aarch64-linux-gnu-gcc --version

# 检查QEMU
qemu-system-x86_64 --version
qemu-system-aarch64 --version

编译第一个UEFI应用

步骤1：创建示例应用

# 创建新的Package
mkdir MyAppPkg
cd MyAppPkg
mkdir -p Applications/HelloWorld

# 创建HelloWorld.c
cat > Applications/HelloWorld/HelloWorld.c << EOF
#include <Uefi.h>
#include <Library/UefiLib.h>

EFI_STATUS
EFIAPI
UefiMain (
  IN EFI_HANDLE        ImageHandle,
  IN EFI_SYSTEM_TABLE  *SystemTable
  )
{
  Print(L"Hello, EDK II Containerized Environment!\n");
  return EFI_SUCCESS;
}
EOF

# 创建INF文件
cat > Applications/HelloWorld/HelloWorld.inf << EOF
[Defines]
  INF_VERSION                    = 0x00010005
  BASE_NAME                      = HelloWorld
  FILE_GUID                      = 12345678-1234-1234-1234-123456789012
  MODULE_TYPE                    = UEFI_APPLICATION
  VERSION_STRING                 = 1.0
  ENTRY_POINT                    = UefiMain

[Sources]
  HelloWorld.c

[Packages]
  MdePkg/MdePkg.dec

[LibraryClasses]
  UefiApplicationEntryPoint
  UefiLib
EOF

# 创建DSC文件
cat > MyAppPkg.dsc << EOF
[Defines]
  PLATFORM_NAME                  = MyAppPkg
  PLATFORM_GUID                  = 87654321-4321-4321-4321-210987654321
  PLATFORM_VERSION               = 0.1
  DSC_SPECIFICATION              = 0x00010005
  OUTPUT_DIRECTORY               = Build/MyAppPkg
  SUPPORTED_ARCHITECTURES        = X64|IA32|AARCH64
  BUILD_TARGETS                  = DEBUG|RELEASE|NOOPT
  SKUID_IDENTIFIER               = DEFAULT

[LibraryClasses]
  UefiApplicationEntryPoint|MdePkg/Library/UefiApplicationEntryPoint/UefiApplicationEntryPoint.inf
  UefiLib|MdePkg/Library/UefiLib/UefiLib.inf

[Components]
  MyAppPkg/Applications/HelloWorld/HelloWorld.inf
EOF

步骤2：编译应用

# 配置编译环境
edksetup.sh

# 编译X64架构DEBUG版本
build -p MyAppPkg/MyAppPkg.dsc -a X64 -t GCC5 -b DEBUG

# 编译AARCH64架构RELEASE版本
build -p MyAppPkg/MyAppPkg.dsc -a AARCH64 -t GCC5 -b RELEASE

编译成功后，输出文件将位于：

  • X64 DEBUG: Build/MyAppPkg/X64/Debug/HelloWorld/HelloWorld.efi
  • AARCH64 RELEASE: Build/MyAppPkg/AARCH64/Release/HelloWorld/HelloWorld.efi

步骤3：在QEMU中运行应用

创建运行脚本run_hello_world.sh：

#!/bin/bash

# 创建虚拟磁盘
dd if=/dev/zero of=fat.img bs=1M count=16
mkfs.vfat fat.img

# 创建挂载点并复制EFI文件
mkdir -p mnt
mount -o loop fat.img mnt
mkdir -p mnt/EFI/BOOT
cp Build/MyAppPkg/X64/Debug/HelloWorld/HelloWorld.efi mnt/EFI/BOOT/BOOTX64.EFI
umount mnt
rm -rf mnt

# 使用QEMU运行
qemu-system-x86_64 -bios OvmfPkg/X64/OVMF.fd -hda fat.img -nographic -serial mon:stdio

执行脚本：

chmod +x run_hello_world.sh
./run_hello_world.sh

成功运行后，你将看到QEMU中输出：Hello, EDK II Containerized Environment!

高级配置：多架构开发环境

支持的架构与工具链

架构工具链编译命令QEMU命令
x86_64GCC5build -a X64 -t GCC5qemu-system-x86_64
IA32GCC5build -a IA32 -t GCC5qemu-system-i386
AArch64GCC5build -a AARCH64 -t GCC5qemu-system-aarch64 -machine virt
ARMGCC5build -a ARM -t GCC5qemu-system-arm -machine virt

编译OvmfPkg示例

# 编译X64架构的OVMF
build -p OvmfPkg/OvmfPkgX64.dsc -a X64 -t GCC5 -b DEBUG

# 编译AArch64架构的ArmVirtQemu
build -p ArmVirtPkg/ArmVirtQemu.dsc -a AARCH64 -t GCC5 -b RELEASE

调试配置：VS Code + GDB

创建.vscode/launch.json：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Debug EDK II (QEMU)",
            "type": "cppdbg",
            "request": "launch",
            "program": "/usr/bin/qemu-system-x86_64",
            "args": [
                "-bios", "OvmfPkg/X64/OVMF.fd",
                "-hda", "fat.img",
                "-s", "-S",
                "-nographic",
                "-serial", "mon:stdio"
            ],
            "stopAtEntry": false,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": false,
            "MIMode": "gdb",
            "miDebuggerPath": "/usr/bin/gdb",
            "miDebuggerServerAddress": "localhost:1234",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ]
        }
    ]
}

问题排查与解决方案

常见问题

  1. 编译错误：BaseTools未找到
ERROR: Unable to locate EDK II BaseTools. Please set EDK_TOOLS_PATH correctly.

解决方案：确保已编译BaseTools

make -C BaseTools
  1. QEMU启动失败：OVMF.fd未找到
qemu-system-x86_64: -bios OvmfPkg/X64/OVMF.fd: Could not open 'OvmfPkg/X64/OVMF.fd': No such file or directory

解决方案：编译OVMF固件

build -p OvmfPkg/OvmfPkgX64.dsc -a X64 -t GCC5 -b DEBUG
  1. 交叉编译错误：aarch64-linux-gnu-gcc未找到
ERROR: Cannot find compiler aarch64-linux-gnu-gcc in PATH

解决方案：安装交叉编译工具链

apt-get install gcc-aarch64-linux-gnu g++-aarch64-linux-gnu

总结与展望

本文介绍了一种基于VS Code和Docker的EDK II容器化开发环境搭建方案，通过容器化技术解决了传统开发环境配置复杂、跨平台兼容性差等问题。通过这种方案，开发者可以快速搭建标准化的EDK II开发环境，专注于固件开发而非环境配置。

未来可以进一步优化的方向：

  1. CI/CD集成：将容器化环境与GitHub Actions或GitLab CI集成，实现自动化构建和测试
  2. 多版本工具链：在容器中集成多个版本的编译工具链，支持不同EDK II版本开发
  3. 调试功能增强：通过GDB和QEMU实现源码级调试，支持断点、变量监视等功能
  4. 镜像优化：减小Docker镜像体积，提高启动速度

希望本文能帮助你更高效地进行EDK II开发，如果你有任何问题或改进建议，欢迎在评论区留言讨论。

附录：常用命令速查表

功能命令
初始化环境edksetup.sh
编译BaseToolsmake -C BaseTools
清理编译产物build clean
编译X64 DEBUG版本build -a X64 -t GCC5 -b DEBUG
编译AARCH64 RELEASE版本build -a AARCH64 -t GCC5 -b RELEASE
运行QEMU (X64)qemu-system-x86_64 -bios OvmfPkg/X64/OVMF.fd -hda fat.img
运行QEMU (AArch64)qemu-system-aarch64 -bios ArmVirtPkg/Qemu/AARCH64/OVMF.fd -machine virt -hda fat.img
查看编译帮助build -h
更新子模块git submodule update --init

【免费下载链接】edk2 EDK II 【免费下载链接】edk2 项目地址: https://gitcode.com/gh_mirrors/ed/edk2

Logo
码道开发者社区

码道开发者社区，聚焦华为云码道 CodeArts 代码智能体，沉淀 Agent、Skill、鸿蒙开发实战内容，供开发者查阅资料、交流技术、分享工程实践

更多推荐

cover

AI 已经能直接改设计稿了:Windows部署Penpot，接入Codex MCP实测

avatar 码道开发者社区
cover

【AI大模型】-DeepSeek Harness 深度解析

avatar 码道开发者社区
cover

实测推荐 3 个 Skill，轻松上手 Codex 网页设计与交付流程

avatar 码道开发者社区