tiny11builder 构建最后一步失败?oscdimg.exe not found 快速排障指南
【免费下载链接】tiny11builderScripts to build a trimmed-down Windows 11 image.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder
tiny11builder 构建精简 Windows 11 镜像,最后一步报 oscdimg.exe not found,ISO 镜像生成失败?两条路线 + 验证清单,照做即可出 ISO。
先说结论
📌 最省事的解法:只把 oscdimg.exe 单个文件(约 100KB)下载到项目根目录,不用装几 GB 的 ADK,构建立刻能走通。如果你本来就常做 Windows 部署,直接装完整 ADK 的部署工具组件,配一次环境变量长期有效。两条路线都能出 ISO,按你手头环境二选一即可。
oscdimg.exe 到底在干嘛
📦 oscdimg.exe 是微软部署工具链里的镜像打包器:你给它一个文件夹(整理好的系统文件加引导信息),它负责压成符合 ISO 9660 标准的镜像,顺带注入引导扇区,让 UEFI 和传统 BIOS 两种模式都能启动。tiny11builder 前面做的删组件、压缩 wim、写应答文件,全是在给这个打包器备料,构建失败绝大多数就栽在最后这一环,工具缺位时前面所有功夫都白费。记住一点:它不是 Windows 自带工具,得从 ADK 或微软符号服务器单独获取,构建脚本的具体逻辑见 tiny11maker.ps1。
路线一:只下载工具文件
📥 适合一次性构建、不想在系统里留几 GB 工具的场景,普通用户权限就能完成,不用管理员。
下载 oscdimg.exe 并校验
一条命令从微软符号服务器拉到项目根目录,成功标志是本地多出 oscdimg.exe 文件:
Invoke-WebRequest -Uri "https://msdl.microsoft.com/download/symbols/oscdimg.exe/3D44737265000/oscdimg.exe" -OutFile ".\oscdimg.exe" -UseBasicParsing再跑一次哈希校验,成功标志是哈希值显示为 3D44737265000:
Get-FileHash -Path ".\oscdimg.exe" -Algorithm MD5下载超时或校验不过,就手动下载这个 exe 放进项目根目录,重走一遍哈希校验即可。
路线二:安装完整 ADK
🧰 适合长期维护构建环境的开发者,磁盘占用约 5GB,但配一次用很久。
一行命令检查 ADK 装没装
递归搜部署工具目录,成功标志是返回 oscdimg.exe 的完整路径:
Get-ChildItem "C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit" -Recurse -Filter "oscdimg.exe"搜不到就以管理员身份跑DISM /Online /Add-Capability /CapabilityName:Tools.Deployment /All装部署组件,装完重跑这条检测。
把 ADKDepTools 环境变量指过去
把变量指到 Oscdimg 目录,命令无报错返回即算成功:
[Environment]::SetEnvironmentVariable("ADKDepTools", "C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\amd64\Oscdimg", "User")设置后必须重启 PowerShell 才生效,老窗口里继续跑构建还会报 not found。
一张表看懂怎么选
| 维度 | 路线一:单文件 | 路线二:完整 ADK |
|---|---|---|
| 磁盘占用 | 约 100KB | 约 5GB |
| 上手成本 | 两条命令,普通权限即可 | 需管理员,还得重启 PowerShell |
| 工具更新 | 手动重新下载 | 跟着 ADK 更新走 |
| 适合谁 | 临时出一次 ISO | 长期维护构建环境 |
怎么确认修好了
✅ 验证分两步。第一步重跑检测:按你走的路线选上面任意一条检测命令,能定位到 oscdimg.exe 就算工具到位;第二步跑完整构建,成功标志是项目目录生成 tiny11.iso,大小通常 3-5GB:
.\tiny11maker.ps1 -Source "D:\Windows11ISO" -Edition "Home"ISO 落盘就大功告成,参数用法可翻 README.md。工具检测通过但构建仍中断的,回到下面的速查表按现象找原因。
报错对照速查
⚠️ 遇到下面几种现象,基本能一眼定位:
| 现象 | 原因 | 处理办法 |
|---|---|---|
| 无法执行 oscdimg.exe | 权限不足 | 管理员身份重开 PowerShell;或icacls ".\oscdimg.exe" /grant Users:RX授权 |
| 多个 oscdimg.exe 实例警告 | 磁盘残留旧版本 | 全盘搜oscdimg.exe,清掉旧文件只留一份 |
| 下载超时或文件损坏 | 网络波动 | 手动下载放进项目根目录,重新做哈希校验 |
| ISO 无法引导 | 工具版本与 Win11 不匹配 | 换 ADK 10.1.22621.x 版本重出镜像 |
【免费下载链接】tiny11builderScripts to build a trimmed-down Windows 11 image.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考