解决 tiny11builder 构建失败oscdimg.exe not found 完整排查与修复指南【免费下载链接】tiny11builderScripts to build a trimmed-down Windows 11 image.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder用 tiny11builder 构建精简版 Windows 11 镜像时最常见的翻车点就是最后一步构建一路正常走到 Creating ISO image... 却提示找不到 oscdimg.exe直接中止。本文先用一条诊断命令确认你当前处于哪种状态再给出轻量与完整两条修复路线每步都能验证跟着做完即可通过验收、生成可用的 tiny11.iso。 如果还没拿到项目源码先克隆它git clone https://gitcode.com/GitHub_Trending/ti/tiny11builder完成后目录里应有 tiny11maker.ps1、README.md 等文件即视为正常。报错现场构建卡在最后的 Creating ISO image...构建前半段复制镜像、挂载、DISM 精简压缩都正常只在打 ISO 这步停下。典型的日志长这样Creating ISO image... ADK folder not found. Will be using bundled oscdimg.exe. Downloading oscdimg.exe... Invoke-WebRequest : 无法连接到远程服务器。 Failed to download oscdimg.exe.关键就在最后两行ADK 没找到回退下载又失败脚本只能中止退出。如果你再新开一个窗口想手动运行 oscdimg 试试还会看到另一种报错PS C:\tiny11builder oscdimg.exe -m -o -u2 .\src .\test.iso oscdimg.exe : 无法将oscdimg.exe项识别为 cmdlet、函数、脚本文件或可运行程序的名称。这是因为 oscdimg.exe 既不在当前目录、也不在 PATH 里——它随 Windows ADK 提供普通系统默认没有它。oscdimg.exe 在构建链路里负责哪一步排查前先花 30 秒看懂这个工具的位置后面所有结论都建立在这三点上它是最后一环也是唯一的外部可执行程序。拆镜像、精简、压缩全靠系统自带的 DISM只有 oscdimg 负责把整个目录封装成 ISO 9660/UDF 光盘镜像并同时写入 BIOS 与 UEFI 双引导扇区所以它无法被 DISM 替代。脚本找工具的顺序是写死的先查 ADK 默认安装目录路径里带 CPU 架构子文件夹再查脚本同目录下的oscdimg.exe都没有才尝试从微软官方源下载。注意收尾动作构建成功后脚本会自动删掉本地下载的 oscdimg.exe。也就是说没有 ADK 的机器每次构建都要重新准备工具。先跑这条诊断命令确认你现在处于哪种状态别急着装东西。下面这条命令模拟了脚本查找工具的完整逻辑一次就能告诉你你在哪种状态# 把第一行改成 tiny11maker.ps1 实际所在的目录 $scriptDir C:\tiny11builder $adkDir C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\$Env:PROCESSOR_ARCHITECTURE\Oscdimg ① ADK默认目录: (Test-Path $adkDir\oscdimg.exe) ② 脚本目录单放: (Test-Path $scriptDir\oscdimg.exe) ③ 架构标识: $Env:PROCESSOR_ARCHITECTURE结果只有三种读法① 为 True → 工具已在位。构建仍报错多半撞上了路径没对上的坑直接看文末速查表。① 为 False、② 为 True → 轻量路线已满足直接跳到验收关。两项都为 False → 这就是你报错的根因没有任何可用工具自动下载又失败了。选下面一条路线修复。 构建时脚本还会在脚本目录生成tiny11_时间戳.log转录文件对照上面报错现场的日志逐行看定位更快。路线 A轻量不装 ADK给脚本目录备一个 oscdimg.exe适合一次性构建、虚拟机、离线机器一共 2 步。第 1 步把 oscdimg.exe 放进 tiny11maker.ps1 所在目录。获取方式二选一能访问微软官方地址的机器不用手动做脚本构建时会自动下载到脚本目录离线或网络不稳的机器从别的机器 ADK 目录里拷一份现成的 oscdimg.exe 放到脚本目录。第 2 步验证文件确实就位路径按实际改Test-Path C:\tiny11builder\oscdimg.exe成功标志输出True重新构建时日志会打印 oscdimg.exe already exists locally.自动下载场景则是 oscdimg.exe downloaded successfully.。路线 B完整安装 ADK 部署工具让脚本自动发现适合经常做镜像的机器一共 2 步。第 1 步安装 Windows ADK用 winget 一条命令最省事winget install --id Microsoft.Windows.Assessment-Deployment-Kit --accept-source-agreements --accept-package-agreements⚠️ 如果你改用 ADK 安装程序手动装组件列表里必须勾选 Deployment Tools——只装 SDK 是不会生成 Oscdimg 文件夹的。装完直接进入第 2 步验证。第 2 步重跑上面诊断命令那一节里的命令确认状态翻转。成功标志① ADK默认目录 的输出由 False 变成 True此后每次构建脚本都会自动用它无需再准备工具。两条路线怎么选一张表对比对比维度路线 A单放工具路线 B安装 ADK一次性成本放/下一个百 KB 级文件安装数 GB 级工具链权限要求普通用户即可需要管理员每次构建成本要重新下载或重放收尾会删零自动发现网络依赖需要除非已有本地副本装完即无附带能力无ADK 部署工具链可留作他用适合人群一次性、临时、离线环境长期镜像开发按场景给一句话推荐长期开发环境选路线 B——脚本自动发现每次构建零准备ADK 工具链还能复用到其他部署工作。临时或一次性构建选路线 A——免安装脚本自动下载、自动清理用完不留痕迹。验收关先最小验证再跑完整构建第 1 步最小验证——先单独跑一下 oscdimg确认工具本身可用路径按你的实际位置改 C:\tiny11builder\oscdimg.exe成功标志控制台打印出 oscdimg 的 Usage 用法说明说明工具没问题若仍报无法识别则是路径写错了。第 2 步完整构建——以管理员身份打开 PowerShell 5.1非管理员运行时脚本会自动提权重开窗口执行Set-ExecutionPolicy Bypass -Scope Process .\tiny11maker.ps1 -ISO E -SCRATCH D其中E是已挂载的 Windows 11 ISO 盘符只填字母、不带冒号D是暂存盘省略时默认用脚本所在目录。✅ 成功标志脚本目录出现tiny11.iso大小通常在 3~5GB日志末尾打印 Creation completed! 即构建通过。高频坑速查现象 → 解法现象明明装了 ADK日志仍显示 ADK folder not found.解法脚本只认默认安装路径加架构子文件夹ADK 装到了自定义目录、或漏勾 Deployment Tools 组件都会被错过 → 重装回默认路径并勾选组件或直接走路线 A。现象第一次构建成功第二次构建突然失败。解法构建收尾会删掉本地 oscdimg.exe第二次启动还要从远程源补拉 autounattend.xml离线机器会直接中止 → 离线环境构建前把这两个文件备份好或装上 ADK 一劳永逸。现象手动敲oscdimg.exe提示不是内部或外部命令。解法它不在 PATH 里脚本也只在两个固定位置ADK 默认目录、脚本目录找工具 → 把文件放到正确位置再用完整路径验证。现象下载环节超时重试依旧失败。解法代理或防火墙拦截所致 → 手动放置工具改走路线 A 的离线做法或先给 PowerShell 配置好系统代理再重试。【免费下载链接】tiny11builderScripts to build a trimmed-down Windows 11 image.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考