解决 tiny11builder 构建失败：oscdimg.exe 配置全方案
【免费下载链接】tiny11builderScripts to build a trimmed-down Windows 11 image.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder
背景速览
你用 tiny11builder 精简并打包 Windows 11 镜像时，构建会卡在收尾的 ISO 生成阶段，抛出oscdimg.exe not found报错。
直接原因是系统缺少 ADK（Assessment and Deployment Kit，ADK）部署工具，而脚本的自动下载兜底又因网络问题失败，导致找不到 ISO 打包器。
原理速通
oscdimg.exe 负责把整理好的镜像目录转换成可引导 ISO：它写入 BIOS 引导扇区 etfsboot.com 与 UEFI 引导文件 efisys.bin，并按 ISO 9660 标准生成文件系统。
在构建流程里，脚本完成镜像处理、复制应答文件 autounattend.xml 之后，才在收尾阶段调用该工具。它优先在 ADK 默认目录...\Deployment Tools\<架构>\Oscdimg里查找，查不到就自动从脚本目录取 oscdimg.exe 副本，构建成功后会删掉临时文件。
实操路径
如果你还没有拿到脚本，先克隆仓库：
git clone https://gitcode.com/GitHub_Trending/ti/tiny11builder克隆后进入项目目录，后续命令都在同一目录的 PowerShell 会话中执行。
临时修复 · 3 步跑通
适用于一次性构建或非开发环境，把 oscdimg.exe 放进脚本根目录，构建时直接使用本地副本。
第 1 步 · 检查本地是否已有副本
Test-Path ".\oscdimg.exe"💡 返回 True 时跳过下载，直接进入第 3 步校验完整性。
第 2 步 · 拉取工具并放入脚本目录
Invoke-WebRequest -Uri "https://msdl.microsoft.com/download/symbols/oscdimg.exe/3D44737265000/oscdimg.exe" -OutFile ".\oscdimg.exe" -UseBasicParsing⚠️ 该地址为符号服务器，网络不佳会超时，此时手动下载并放到同一目录。
第 3 步 · 校验文件完整性
(Get-FileHash -Path ".\oscdimg.exe" -Algorithm MD5).Hash💡 输出的哈希应为
3D44737265000，不一致就删掉重新下载。
长期配置 · 完整部署
面向持续做 Windows 镜像开发的环境，安装 ADK 部署工具后脚本会自动命中默认路径，免去每次构建手动下载。
安装部署工具
DISM /Online /Add-Capability /CapabilityName:Tools.Deployment /All验证工具落位
Get-ChildItem "C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit" -Recurse -Filter "oscdimg.exe"预期输出：返回至少一条以\Oscdimg\oscdimg.exe结尾的路径，且架构子目录（amd64 或 arm64）与你的宿主系统一致。
注意脚本中该目录是硬编码的（架构子目录跟随宿主），无需再配置环境变量，装进默认位置即可被识别。
效果确认
重新跑一遍构建，然后验证产物：
Get-Item ".\tiny11.iso" | Select-Object Name, Length成功标志：返回名为 tiny11.iso 的文件，大小在 3~5GB，且脚本以 "Creation completed" 收尾。若文件不存在，先核对传给-ISO的盘符与真实挂载的 ISO 是否一致，再检查-SCRATCH暂存盘剩余空间是否足够。
疑难速查
| 现象 | 根因 | 解法 |
|---|---|---|
oscdimg.exe not found | 系统无 ADK 部署工具且自动下载失败 | 手动拉取工具放入脚本根目录（见第 2 步） |
Failed to download oscdimg.exe | 符号服务器连通性差 | 手动下载并核对 MD5 为3D44737265000后放入目录 |
| 生成 ISO 但无法引导 | 工具版本与 Win11 版本不匹配 | 换用 ADK 10.1.22621.x 重新构建 |
| 多个 oscdimg.exe 实例警告 | 本地与 ADK 副本同时存在 | 删除旧副本：Remove-Item .\oscdimg.exe -Force |
延伸参考
- 标准版构建脚本
- 核心版构建脚本
- OOBE 无人值守应答文件
【免费下载链接】tiny11builderScripts to build a trimmed-down Windows 11 image.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
