tiny11builder「oscdimg.exe not found」构建失败:两条路径完整修复指南
【免费下载链接】tiny11builderScripts to build a trimmed-down Windows 11 image.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder
运行tiny11maker.ps1走到最后生成 ISO 的环节时卡死,报oscdimg.exe not found。原因几乎都是同一个:脚本找不到它需要的oscdimg.exe。这是脚本打包 ISO 必需的工具,补上这一个点,构建就能跑完。最短路径:先按下面自检表决定放单文件还是装完整 ADK,再按步骤执行。
「oscdimg.exe not found」卡在流程哪一步
oscdimg.exe负责整个构建的最后一步:把处理完的构建目录打包成可引导的tiny11.iso。它相当于流水线末端的封箱工位——前面的镜像拷贝、删应用、改注册表、压缩导出都完成了,封箱工位没机器,产品就出不去。
脚本的查找顺序见 tiny11maker.ps1:先查系统 ADK 的Deployment Tools\<架构>\Oscdimg目录,存在就用 ADK 版;否则用脚本目录里的oscdimg.exe,还没有就尝试联网下载。失败链条是:ADK 未安装 → 回落到本地文件 → 本地没有且下载失败 →oscdimg.exe not found→ 构建中断。
用自检表决定装 ADK 还是放单文件
| 自检点 | 是 → | 否 → |
|---|---|---|
| 是否长期做 Windows 镜像构建 | 走路径 B(装完整 ADK) | 走路径 A(单文件) |
| 机器能否连通微软符号服务器 | 路径 A 可依赖脚本自动下载 | 手动把文件拷进脚本目录 |
| 机器有管理员权限装软件吗 | 可走路径 B | 只能走路径 A |
按行锁定一条路径,不要两条都做。
路径 A:把单个oscdimg.exe放进脚本目录
适用场景:偶尔构建一次,不想装几 GB 的 ADK。前置条件:PowerShell 5.1;构建需要以管理员运行(脚本非管理员时会自动重启窗口)。
- 进入脚本所在目录,确认主文件在场。
dir tiny11maker.ps1成功标志:输出里包含tiny11maker.ps1。
- 检查
oscdimg.exe是否已存在。
dir oscdimg.exe存在就跳过下一步,直接去验证章节;不存在再执行第 3 步。
- 让文件落进目录。网络可用就直接跑构建,脚本到 ISO 环节会自动下载;网络受限时,从另一台装了 ADK 的机器上把
Oscdimg目录里的oscdimg.exe拷到本目录。
✅ 成功标志:日志出现下载完成的提示,或dir能看到该文件。
注意:脚本构建成功后会自动删掉oscdimg.exe,事后看不到该文件属正常现象。
路径 B:装完整 Windows ADK 部署工具
适用场景:机器长期构建镜像,或还需要 ADK 的其他部署工具。前置条件:管理员权限,约 5 GB 磁盘空间。
- 安装 Windows ADK,功能里只勾「部署工具(Deployment Tools)」,其余不勾。
- 验证脚本真正会读取的路径(架构名由
$env:PROCESSOR_ARCHITECTURE拼出):
Test-Path "C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\$env:PROCESSOR_ARCHITECTURE\Oscdimg"✅ 成功标志:输出True,且构建到 ISO 环节时日志打印Will be using oscdimg.exe from system ADK.。
脚本会自动探测该路径,不需要配置任何环境变量。
跑两级测试确认修好
最小验证:直接执行你补好的工具,看是否打印用法。把下面路径换成你的实际路径(脚本目录或 ADK 目录)。
& "C:\path\to\oscdimg.exe" /?成功标志:打印出Usage: oscdimg /m|/v /o ...一行的用法说明。
完整验证:挂载 Windows 11 安装 ISO 后(挂载方法见 README.md),端到端跑一遍。
Set-ExecutionPolicy Bypass -Scope Process .\tiny11maker.ps1 -ISO E -SCRATCH D成功标志:脚本目录出现tiny11.iso(约 3~5 GB),窗口打印Creation completed!
排障速查
| 现象 | 可能原因 | 处置动作 |
|---|---|---|
oscdimg.exe not found | ADK 未装且自动下载失败,脚本目录无文件 | 按路径 A 三步走,先落文件再跑构建 |
日志出现Downloading oscdimg.exe...后卡死或超时 | 连不通符号服务器(网络受限/代理) | 从装了 ADK 的机器拷贝oscdimg.exe到脚本目录 |
| ADK 装好了仍报找不到 | 架构目录名不匹配(arm64 机器指到 amd64) | 重跑路径 B 的Test-Path确认实际路径 |
oscdimg.exe存在但报缺 DLL / Win32 错误 | 文件不完整(下载中断) | 删掉重新下载,或从 ADK 拷贝完整文件 |
tiny11.iso生成了但无法引导 | 源 ISO 损坏或缺引导文件 | 校验源 ISO 完整性,重新跑完整构建 |
oscdimg.exe是脚本自动定位的工具,放进脚本目录或 ADK 目录任一位置,构建就能通过最后一关。
【免费下载链接】tiny11builderScripts to build a trimmed-down Windows 11 image.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder
创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考