Windows10 VS2019 下 EDKII 开发环境全流程避坑指南最近在折腾UEFI开发环境的朋友们你们是否也经历过这样的痛苦照着网上的教程一步步操作结果卡在某个莫名其妙的报错上查遍全网都找不到解决方案作为一个从Windows7时代就开始接触EDKII的老玩家我深知环境配置过程中的各种坑。本文将带你避开所有常见陷阱从零开始搭建一个稳定可靠的UEFI开发环境。1. 环境准备选对工具版本是关键在开始之前我必须强调一个血泪教训工具链版本的选择直接决定了配置过程的难易程度。经过多次测试验证以下是经过验证的最佳组合操作系统Windows 10 21H2中文系统需额外配置开发工具Visual Studio 2019 16.11社区版即可Python3.7.x3.8版本可能导致兼容性问题NASM2.15.05IASL20200528注意VS2022虽然更新但EDKII官方尚未完全支持强行使用会导致编译失败。同样Windows 11存在已知的VS2019兼容性问题。1.1 安装VS2019的正确姿势安装VS2019时工作负载选择至关重要。以下是必须勾选的组件1. 使用C的桌面开发 - MSVC v142 - VS2019 C x64/x86生成工具 - Windows 10 SDK (10.0.19041.0) 2. 单个组件 - C ATL for v142生成工具常见陷阱如果同时安装了多个版本的Windows SDK会导致编译时工具链冲突。建议在安装前通过控制面板卸载旧版本SDK。1.2 依赖工具安装要点Python安装勾选Add Python to PATH选项安装完成后验证python --version应显示3.7.xNASM配置解压到不含空格的路径如C:\NASM将nasm.exe所在目录加入系统PATHIASL注意事项解压后建议放在C:\ASL目录如果使用其他路径需修改EDK2的tools_def.txtDEFINE IASL_BIN C:\ASL\iasl.exe2. EDKII源码获取与初始化2.1 获取完整代码库EDKII的代码结构比较特殊直接下载zip包会缺少关键子模块。正确做法是git clone https://github.com/tianocore/edk2.git cd edk2 git submodule update --init如果网络环境不佳可以尝试镜像源git clone https://gitee.com/mirrors/edk2.git2.2 首次环境配置执行初始化脚本生成配置文件edksetup.bat这会创建Conf/target.txt和Conf/tools_def.txt。需要检查以下关键参数# target.txt ACTIVE_PLATFORM EmulatorPkg/EmulatorPkg.dsc TARGET DEBUG TARGET_ARCH X64 TOOL_CHAIN_TAG VS20193. 环境变量与路径配置3.1 必须设置的系统变量根据你的实际安装路径在系统环境变量中添加变量名示例值NASM_PREFIXC:\NASMPYTHON_HOMEC:\Python37IASL_PREFIXC:\ASLVS2019_PREFIXC:\VS2019\VC\Tools\MSVC\14.29.301333.2 中文系统特殊处理如果你的Windows是中文版可能会遇到输入法冲突问题。解决方案安装英文语言包设置 → 时间和语言 → 语言将非Unicode程序的语言设置为英语重启后确保输入法切换为英文状态4. VS2019项目集成4.1 创建自定义项目打开VS2019 → 继续但无需代码文件 → 新建 → 从现有代码创建项目选择Visual C类型添加UEFI文件类型*.dsc;*.inf;*.dec;*.fdf;*.uni4.2 配置生成命令在项目属性中设置生成命令行call edksetup.bat rebuild调试配置关键参数命令: Build\EmulatorX64\DEBUG_VS2019\X64\WinHost.exe 工作目录: $(ProjectDir)5. QEMU集成与调试5.1 编译OVMF固件创建QemuBuild.bat脚本call edksetup.bat build -p OvmfPkg\OvmfPkgX64.dsc生成的固件位于Build\OvmfX64\DEBUG_VS2019\FV\OVMF.fd5.2 QEMU启动脚本创建run_qemu.batset QEMU_BIOSBuild\OvmfX64\DEBUG_VS2019\FV\OVMF.fd set QEMU_DISKQemuDisk qemu-system-x86_64.exe -bios %QEMU_BIOS% -hda fat:rw:%QEMU_DISK% -net none实用技巧添加-serial file:debug.log参数可以将调试输出保存到文件。6. 常见问题速查表错误现象可能原因解决方案NMAKE : fatal error工具链路径错误检查VS2019_PREFIX变量iasl not foundIASL路径包含中文或空格移动到纯英文路径WinHost窗口无法输入中文输入法冲突切换为英文输入法Invalid parameterPython版本不兼容降级到Python 3.7.xQEMU启动黑屏OVMF固件生成失败检查OvmfPkgX64.dsc编译日志配置过程中最常遇到的坑就是路径问题。建议所有工具都安装在C盘根目录下的英文文件夹中避免使用Program Files等包含空格的路径。如果遇到奇怪的编译错误先执行edksetup.bat cleanall彻底清理再重新build。
告别踩坑！Windows10 + VS2019 下 EDKII 开发环境保姆级配置指南（含QEMU联动）
发布时间：2026/6/14 4:15:09
Windows10 VS2019 下 EDKII 开发环境全流程避坑指南最近在折腾UEFI开发环境的朋友们你们是否也经历过这样的痛苦照着网上的教程一步步操作结果卡在某个莫名其妙的报错上查遍全网都找不到解决方案作为一个从Windows7时代就开始接触EDKII的老玩家我深知环境配置过程中的各种坑。本文将带你避开所有常见陷阱从零开始搭建一个稳定可靠的UEFI开发环境。1. 环境准备选对工具版本是关键在开始之前我必须强调一个血泪教训工具链版本的选择直接决定了配置过程的难易程度。经过多次测试验证以下是经过验证的最佳组合操作系统Windows 10 21H2中文系统需额外配置开发工具Visual Studio 2019 16.11社区版即可Python3.7.x3.8版本可能导致兼容性问题NASM2.15.05IASL20200528注意VS2022虽然更新但EDKII官方尚未完全支持强行使用会导致编译失败。同样Windows 11存在已知的VS2019兼容性问题。1.1 安装VS2019的正确姿势安装VS2019时工作负载选择至关重要。以下是必须勾选的组件1. 使用C的桌面开发 - MSVC v142 - VS2019 C x64/x86生成工具 - Windows 10 SDK (10.0.19041.0) 2. 单个组件 - C ATL for v142生成工具常见陷阱如果同时安装了多个版本的Windows SDK会导致编译时工具链冲突。建议在安装前通过控制面板卸载旧版本SDK。1.2 依赖工具安装要点Python安装勾选Add Python to PATH选项安装完成后验证python --version应显示3.7.xNASM配置解压到不含空格的路径如C:\NASM将nasm.exe所在目录加入系统PATHIASL注意事项解压后建议放在C:\ASL目录如果使用其他路径需修改EDK2的tools_def.txtDEFINE IASL_BIN C:\ASL\iasl.exe2. EDKII源码获取与初始化2.1 获取完整代码库EDKII的代码结构比较特殊直接下载zip包会缺少关键子模块。正确做法是git clone https://github.com/tianocore/edk2.git cd edk2 git submodule update --init如果网络环境不佳可以尝试镜像源git clone https://gitee.com/mirrors/edk2.git2.2 首次环境配置执行初始化脚本生成配置文件edksetup.bat这会创建Conf/target.txt和Conf/tools_def.txt。需要检查以下关键参数# target.txt ACTIVE_PLATFORM EmulatorPkg/EmulatorPkg.dsc TARGET DEBUG TARGET_ARCH X64 TOOL_CHAIN_TAG VS20193. 环境变量与路径配置3.1 必须设置的系统变量根据你的实际安装路径在系统环境变量中添加变量名示例值NASM_PREFIXC:\NASMPYTHON_HOMEC:\Python37IASL_PREFIXC:\ASLVS2019_PREFIXC:\VS2019\VC\Tools\MSVC\14.29.301333.2 中文系统特殊处理如果你的Windows是中文版可能会遇到输入法冲突问题。解决方案安装英文语言包设置 → 时间和语言 → 语言将非Unicode程序的语言设置为英语重启后确保输入法切换为英文状态4. VS2019项目集成4.1 创建自定义项目打开VS2019 → 继续但无需代码文件 → 新建 → 从现有代码创建项目选择Visual C类型添加UEFI文件类型*.dsc;*.inf;*.dec;*.fdf;*.uni4.2 配置生成命令在项目属性中设置生成命令行call edksetup.bat rebuild调试配置关键参数命令: Build\EmulatorX64\DEBUG_VS2019\X64\WinHost.exe 工作目录: $(ProjectDir)5. QEMU集成与调试5.1 编译OVMF固件创建QemuBuild.bat脚本call edksetup.bat build -p OvmfPkg\OvmfPkgX64.dsc生成的固件位于Build\OvmfX64\DEBUG_VS2019\FV\OVMF.fd5.2 QEMU启动脚本创建run_qemu.batset QEMU_BIOSBuild\OvmfX64\DEBUG_VS2019\FV\OVMF.fd set QEMU_DISKQemuDisk qemu-system-x86_64.exe -bios %QEMU_BIOS% -hda fat:rw:%QEMU_DISK% -net none实用技巧添加-serial file:debug.log参数可以将调试输出保存到文件。6. 常见问题速查表错误现象可能原因解决方案NMAKE : fatal error工具链路径错误检查VS2019_PREFIX变量iasl not foundIASL路径包含中文或空格移动到纯英文路径WinHost窗口无法输入中文输入法冲突切换为英文输入法Invalid parameterPython版本不兼容降级到Python 3.7.xQEMU启动黑屏OVMF固件生成失败检查OvmfPkgX64.dsc编译日志配置过程中最常遇到的坑就是路径问题。建议所有工具都安装在C盘根目录下的英文文件夹中避免使用Program Files等包含空格的路径。如果遇到奇怪的编译错误先执行edksetup.bat cleanall彻底清理再重新build。
相关文章
Vivado 2023.1及更早版本永久License全功能解锁：HLS、System Generator等IP核使用详解
Vivado全功能许可证深度解析：解锁HLS与System Generator等高级工具 在FPGA开发领域，Xilinx Vivado设计套件无疑是工程师们最强大的武器之一。但许多中级开发者常常遇到一个令人困惑的问题：为什么有些高级功能无法使用？答案往往隐藏…
甲骨云VPS到手后第一件事：用一键DD脚本换个纯净系统（附Debian 11/Ubuntu 22.04命令）
甲骨文云VPS初始化指南：从系统重装到安全加固全流程 刚拿到甲骨文云VPS时，许多用户会忽略一个关键步骤——系统初始化。预装系统往往带有各种不必要的组件和潜在限制，就像买来新手机第一时间要卸载预装应用一样。本文将带你完成从系统重装到安…
ops-cv的定位与问题域：为什么需要NPU上的CV算子，以及ops-cv在CANN算子体系中的角色
前言 当你在昇腾NPU上部署一个目标检测模型时，是否曾困惑过这样的问题：明明模型推理可以在NPU上跑满算力，但图像预处理环节却成了一块挥之不去的短板？Resize操作要反复调用CPU算子，颜色空间转换动不动就要跨设备搬运数…
别再手动处理图片特征了！用Milvus + Towhee 5分钟搞定一个以图搜图Demo
5分钟构建以图搜图系统：Milvus与Towhee的高效组合实践 在数字内容爆炸式增长的今天，快速准确地检索图像已成为众多应用的核心需求。传统的关键词搜索在面对海量非结构化图像数据时显得力不从心，而以图搜图技术正逐渐成为解决这一痛点的利器。…
告别串口！用CH582的USB Bootloader实现U盘拖拽式固件升级（基于PlumBL框架）
告别串口！用CH582的USB Bootloader实现U盘拖拽式固件升级（基于PlumBL框架） 嵌入式开发中，固件升级一直是让人头疼的环节——串口线连接不稳定、上位机工具配置复杂、驱动程序兼容性问题频发。现在，基于CH582芯片和Plum…
逻辑综合避坑指南：手把手教你配置Design Compiler的target_library和link_library（以90nm典型库为例）
逻辑综合避坑指南：深度解析Design Compiler库配置的底层逻辑 在数字IC设计流程中，逻辑综合是将RTL代码转化为门级网表的关键环节。许多工程师往往将注意力集中在约束设置和优化策略上，却忽略了最基础的库配置环节。实际上， 超过6…
别再只会用库函数了！C++中5种GCD算法实现大比拼（附性能测试）
C中5种GCD算法实现深度评测与工程实践指南在算法竞赛和高性能计算领域，最大公约数(GCD)计算看似基础却暗藏玄机。许多开发者习惯性地调用标准库函数，却不知道不同实现方式可能存在数量级的性能差异。本文将深入剖析五种主流GCD算法的实现原理，…
Vector vs ETAS：一个AUTOSAR工程师的踩坑实录与选型避坑指南
Vector vs ETAS：一个AUTOSAR工程师的踩坑实录与选型避坑指南当项目进度表上的红色预警灯开始闪烁，我才真正理解AUTOSAR工具链选型不是技术选择题，而是关乎团队生死存亡的战略决策。三年前那个暴雨夜，我们团队在实验室通宵手动合并…
从ONNX Runtime 1.8到1.20：一张图看懂CUDA支持变迁史与升级指南
ONNX Runtime与CUDA版本演进全解析：从兼容性适配到性能跃迁当深度学习框架的版本号不断攀升时，技术决策者往往面临一个看似简单却影响深远的抉择：如何平衡框架更新与计算基础设施的稳定性？ONNX Runtime作为跨平台推理引擎…
音乐文件解锁实战指南：3个场景解决你的播放困境
音乐文件解锁实战指南：3个场景解决你的播放困境 【免费下载链接】unlock-music 在浏览器中解锁加密的音乐文件。原仓库： 1. https://github.com/unlock-music/unlock-music ；2. https://git.unlock-music.dev/um/web 项目地址: https://git…
从Landsat到高分系列：手把手教你选择适合自己项目的遥感卫星数据
遥感卫星数据选型实战指南：从参数解析到场景化应用当面对GEE、PIE-Engine等云平台上数十种遥感数据源时，许多研究者常陷入选择困难——Landsat的历史连续性、Sentinel-2的红边波段优势、高分系列的亚米级分辨率各有千秋。本文将打破常规参数罗列式对比&a…
MC68302 AutoBaud技术：硬件级串口波特率自动检测原理与实现
1. 项目概述：MC68302 AutoBaud技术深度解析在嵌入式系统开发，尤其是那些需要与外部设备进行串口通信的场景里，最让人头疼的环节之一就是波特率匹配。想象一下，你设计了一个数据采集终端，需要连接来自不同厂家、不同年代…
音乐文件解锁实战指南：3个场景解决你的播放困境
音乐文件解锁实战指南：3个场景解决你的播放困境 【免费下载链接】unlock-music 在浏览器中解锁加密的音乐文件。原仓库： 1. https://github.com/unlock-music/unlock-music ；2. https://git.unlock-music.dev/um/web 项目地址: https://git…
从Landsat到高分系列：手把手教你选择适合自己项目的遥感卫星数据
遥感卫星数据选型实战指南：从参数解析到场景化应用当面对GEE、PIE-Engine等云平台上数十种遥感数据源时，许多研究者常陷入选择困难——Landsat的历史连续性、Sentinel-2的红边波段优势、高分系列的亚米级分辨率各有千秋。本文将打破常规参数罗列式对比&a…
MC68302 AutoBaud技术：硬件级串口波特率自动检测原理与实现
1. 项目概述：MC68302 AutoBaud技术深度解析在嵌入式系统开发，尤其是那些需要与外部设备进行串口通信的场景里，最让人头疼的环节之一就是波特率匹配。想象一下，你设计了一个数据采集终端，需要连接来自不同厂家、不同年代…
Zotero Duplicates Merger：5步彻底清理文献库重复条目
Zotero Duplicates Merger：5步彻底清理文献库重复条目 【免费下载链接】ZoteroDuplicatesMerger A zotero plugin to automatically merge duplicate items 项目地址: https://gitcode.com/gh_mirrors/zo/ZoteroDuplicatesMerger 还在为文献库中堆积如山的重…
利用随机有限集理论对蜂群的ILQR和MPC控制研究附Matlab代码
✅作者简介：热爱科研的Matlab仿真开发者，擅长数据处理、建模仿真、程序设计、完整代码获取、论文复现及科研仿真。🍎 往期回顾关注个人主页：Matlab科研工作室🍊个人信条：格物致知,完整Matlab代码及仿真咨询…
为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因
更多请点击： https://intelliparadigm.com 第一章：为什么你的Gemini邮件CTE低于行业均值2.8倍？：从Prompt架构到发送时序的深度归因 Gemini邮件的客户转化效率（CTE）显著偏低，根本原因常被误判为…