企业官网建设流程全解析

tiny11builder 构建失败：oscdimg.exe 缺失、ISO 生成失败如何 3 步修好（附最快路径）

【免费下载链接】tiny11builderScripts to build a trimmed-down Windows 11 image.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder

用 tiny11builder 构建精简 Windows 11 镜像时，如果走到 ISO 生成环节就报 “oscdimg.exe not found”、构建直接失败，别慌：对大多数人来说，最快的路是手动把一个 oscdimg.exe 放进项目目录，3 条命令搞定。👇

2 分钟轻量修复：把 oscdimg.exe 放进项目目录

脚本的内置逻辑是：先找系统 ADK（Assessment and Deployment Kit，微软官方的 Windows 部署工具包），找不到就退回使用脚本同目录下的 oscdimg.exe。这段选择逻辑就在 tiny11maker.ps1 的第 441–469 行。所以最快的办法，是自己把这个文件补齐。

从微软符号服务器把工具拉到项目根目录，顺手算一遍 MD5 确认文件完整：

Invoke-WebRequest -Uri "https://msdl.microsoft.com/download/symbols/oscdimg.exe/3D44737265000/oscdimg.exe" -OutFile ".\oscdimg.exe" -UseBasicParsing Get-FileHash -Path ".\oscdimg.exe" -Algorithm MD5

怎么判断成了：项目根目录出现 oscdimg.exe（约 100KB），且哈希值显示为3D44737265000。

然后重新跑你的构建（参数用法见 README.md），流程末尾会在项目目录产出tiny11.iso，大小一般 3–5GB。

它为什么找不到：这个工具到底在干什么

oscdimg.exe 相当于构建链路里的“压制机”：DISM 把系统精简压缩成一棵文件树之后，得由它压成一张能引导启动的 ISO（同时支持 UEFI 与传统 BIOS 两种启动方式）。机器上没装 ADK，脚本自然找不到这台“压机”，最后一步就卡死。所以这类构建失败大多不是脚本的 bug，只是缺工具。

两条补齐路线，按使用频率选

轻量独立工具：偶尔构建一次就用它

如果你只是偶尔构建 Windows 11 镜像，这条路线就够：体积 100KB 级、不需要管理员权限、用完不占地方，零维护成本。步骤上一节已经全部执行完，你只需确认构建窗口打印出 “ADK folder not found. Will be using bundled oscdimg.exe.”，就说明已切换到同目录工具，配置生效。

ADK 一步集成：长期做镜像开发就装它

如果你经常构建镜像，就把完整 ADK 装一次（约 5GB）完成配置，一劳永逸：版本自动同步，不用每次再单独下工具。

第一步：先确认机器上是否已有 ADK，并定位 oscdimg.exe 在哪：

Get-ChildItem "C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit" -Recurse -Filter "oscdimg.exe"

如果返回了带 oscdimg.exe 的完整路径，直接跳到最后的校验。

第二步：没有的话，用管理员权限 PowerShell 装部署工具组件：

DISM /Online /Add-Capability /CapabilityName:Tools.Deployment /All

怎么判断成了：打印 “The operation completed successfully.”。

第三步：把 ADKDepTools 环境变量写到当前用户，同时载入当前会话：

[Environment]::SetEnvironmentVariable("ADKDepTools", "C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\amd64\Oscdimg", "User") $env:ADKDepTools = "C:\Program Files (x86)\Windows Kits\10\Assessment and Deployment Kit\Deployment Tools\amd64\Oscdimg"

怎么判断成了：重开一个 PowerShell，echo $env:ADKDepTools能显示上面的路径（持久化部分需重启会话才生效）。

最后跑一次工具自检：

.\tiny11maker.ps1 -ValidateTools

输出 “oscdimg.exe validation passed” 即配置有效；此时跑一次完整构建，项目目录里会出现约 3–5GB 的tiny11.iso。

避坑速查

遇到 “无法执行 oscdimg.exe” 时，先用管理员权限打开读取权限：

icacls ".\oscdimg.exe" /grant Users:RX

其余高频故障对照处理：

一句话收束：偶尔构建选轻量工具，长期构建装 ADK。只要 oscdimg.exe 到位，ISO 生成这一步基本不会再给你添堵。✅

【免费下载链接】tiny11builderScripts to build a trimmed-down Windows 11 image.项目地址: https://gitcode.com/GitHub_Trending/ti/tiny11builder