告别编译报错！手把手教你用VS2019和Python3.9搞定最新EDK2环境（附子模块下载避坑指南）-酒店常州论坛

告别编译报错！手把手教你用VS2019和Python3.9搞定最新EDK2环境（附子模块下载避坑指南）

当你在深夜的显示器前第三次看到edksetup.bat弹出的红色报错时，那种挫败感我深有体会。UEFI开发环境的搭建就像在玩一个没有攻略的拼图游戏——BaseTools编译失败、Python版本冲突、子模块下载卡顿，每个环节都可能成为拦路虎。本文将用我踩过的坑为你铺路，从VS2019组件选择到子模块手动部署，带你跨过所有常见陷阱。

1. 开发环境精准配置：避开90%的初始化错误

1.1 Visual Studio 2019组件选择指南

安装VS2019时，默认选项就像自助餐厅的托盘——看似丰盛实则缺少关键营养。通过分析BaseTools的编译日志，这些才是必选项目：

组件分类	必须勾选项	作用说明
Windows开发	C++桌面开发	提供nmake等编译工具链
单个组件	Windows 10 SDK (10.0.19041.0)	基础API支持
编译器工具集	MSVC v142 - VS2019 C++ x64/x86	EDK2代码编译核心依赖

注意：如果已安装VS但缺少组件，无需重装，通过Visual Studio Installer的"修改"功能即可追加。

1.2 Python环境避坑三原则

Python版本就像调音器——差半个音阶都会跑调。经过20+次测试验证，这三个配置要点决定成败：

版本锁定：官方推荐Python 3.6-3.9，但3.9.6版本在BaseTools编译时表现最稳定
路径规范：安装时务必勾选Add Python to PATH，避免后续手动配置出错
权限处理：以管理员身份运行CMD后，执行以下命令验证环境：

python -c "import sys; print(sys.version)" py -3.9 -c "print('Alternate launcher works')"

提示：若遇到python不是内部命令，检查PATH是否包含类似C:\Users\YourName\AppData\Local\Programs\Python\Python39的路径

2. 源码获取与子模块处理：突破网络封锁的实战方案

2.1 国内开发者的镜像加速方案

当git clone卡在Receiving objects时，这些方法能节省90%等待时间：

Gitee镜像同步（每日更新）：

git clone https://gitee.com/mirrors/edk2.git cd edk2 && git checkout edk2-stable202208

子模块手动部署（以brotli为例）：
1. 访问https://github.com/google/brotli/tags下载v1.0.9.zip
2. 解压到edk2/BaseTools/Source/C/BrotliCompress/brotli
3. 创建空文件brotli/.gitkeep绕过子模块检查

2.2 关键子模块目录结构速查表

就像乐高说明书上的零件编号，这些路径必须精确匹配：

子模块名称	正确存放路径	影响范围
openssl	CryptoPkg/Library/OpensslLib/openssl	安全协议相关模块编译
brotli	MdeModulePkg/Library/BrotliCustomDecompressLib/brotli	固件压缩功能

实测技巧：用tree /F > dir.txt生成目录树，对比验证结构完整性

3. BaseTools编译全流程：从报错到生成的关键转折

3.1 编译前必须执行的环境检查

在按下回车键前，这三个检查项能避免80%的后续报错：

VC环境激活：

call "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" x86

Python路径确认：
```
where python && where py
```
临时文件清理：
```
del /Q BaseTools\Bin\Win32\*.* 2>nul
```

3.2 分步编译与错误解读

当看到error C2065: undeclared identifier时，别急着重装，试试这个流程：

首次编译尝试：
```
edksetup.bat Rebuild
```
常见错误处理：
- 缺失Windows.h：检查VS2019的Windows SDK版本
- LNK2001链接错误：重新执行vcvarsall.bat

成功标志：

Copying 142 files to BaseTools\Bin\Win32

注意：若遇到nmake : fatal error U1077，尝试将BaseTools\Source\C\Makefiles中的CC_FLAGS加上/wd4819

4. OVMF编译实战：从配置到固件生成

4.1 目标配置的黄金参数组合

在Conf\target.txt中，这些设置经过50+次测试验证：

ACTIVE_PLATFORM = OvmfPkg/OvmfPkgX64.dsc TARGET = DEBUG TARGET_ARCH = X64 TOOL_CHAIN_TAG = VS2019 MAX_CONCURRENT_THREAD = 4 # 根据CPU核心数调整

4.2 编译命令的隐藏技巧

不要直接运行build，先执行这个预处理：

set PYTHON_COMMAND=py -3.9 set EDK_TOOLS_PATH=%CD%\BaseTools call edksetup.bat

完整编译命令应包含详细日志：

build -p OvmfPkg/OvmfPkgX64.dsc -a X64 -t VS2019 -b DEBUG -D FD_SIZE_2GB -v 2>&1 | tee build.log

4.3 成功验证三要素

当看到Done时，按这个清单检查产出物：

固件文件：

Build\OvmfX64\DEBUG_VS2019\FV\OVMF.fd (通常约2MB)

日志关键行：
```
Generating Fixed Flash Image File...
```

QEMU测试命令：

qemu-system-x86_64 -bios OVMF.fd -m 2048

在最近为某硬件厂商定制固件时，发现将FD_SIZE_2GB改为FD_SIZE_4GB可解决大内存设备启动问题。这个参数藏在OvmfPkgX64.dsc中，修改后需要clean重新编译：

build cleanall && build -p OvmfPkg/OvmfPkgX64.dsc ...

企业官网建设流程全解析