遇到.NET Framework错误应依次使用官方修复工具、重新注册组件、运行DISM/SFC、清理重装目标版本、重置Windows功能；每步均需管理员权限，最后重启生效。
如果您在Windows系统中运行依赖.NET Framework的应用程序时遇到错误提示，例如“无法加载文件或程序集”“未能加载类型”或“CLR初始化失败”，则可能是.NET Framework组件损坏、版本冲突或注册表项异常所致。以下是修复此类问题的具体步骤：
一、使用.NET Framework修复工具
微软官方提供独立的.NET Framework修复工具（.NET Framework Repair Tool），可自动检测并修复常见安装损坏、缓存异常及清单不一致等问题，无需手动卸载重装。
1、访问微软官方支持页面，下载最新版.NET Framework Repair Tool（支持.NET Framework 4.5至4.8）。
2、以管理员身份运行下载的RepairTool.exe文件。
3、点击“Next”进入向导，选择默认修复模式（Recommended Repair）。
4、等待扫描完成，工具将自动识别损坏项并执行修复，完成后提示“Repair completed successfully”。
二、重新注册.NET Framework系统组件
部分错误源于.NET Framework相关DLL未正确注册到Windows系统中，尤其是mscorwks.dll、clr.dll等核心运行时文件，可通过命令行强制重新注册。
1、以管理员身份打开命令提示符（CMD）或PowerShell。
2、依次执行以下两条命令（按回车运行每条）：
cd /d %windir%\Microsoft.NET\Framework64\v4.0.30319
ngen update /force
3、若系统为32位或需同时修复x86环境，再执行：
cd /d %windir%\Microsoft.NET\Framework\v4.0.30319
ngen update /force
三、执行DISM与SFC系统映像修复
当.NET Framework文件被系统级损坏（如被误删、杀毒软件隔离或Windows更新中断），底层系统映像可能已不完整，需通过DISM还原基础组件，并用SFC校验签名文件。
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
1、以管理员身份运行命令提示符。
2、输入并执行：DISM /Online /Cleanup-Image /RestoreHealth，等待进度达100%。
3、执行完毕后立即运行：sfc /scannow，确保所有受保护的系统文件（含.NET相关dll）恢复原始状态。
4、操作完成后重启计算机。
四、清理并重新安装目标.NET Framework版本
当特定版本（如4.7.2或4.8）完全失效且前述方法无效时，需彻底清除其安装痕迹，再执行纯净安装，避免残留注册表项干扰。
1、下载并运行.NET Framework Cleanup Tool（由微软原团队开发，支持4.0–4.8）。
2、选择对应损坏的.NET Framework主版本（如4.8），点击“Cleanup”按钮，完成卸载。
3、前往微软官网下载该版本的离线安装包（例如ndp48-x86-x64-allos-enu.exe）。
4、断开网络连接，以管理员身份运行安装包，勾选“我同意许可条款”后点击安装。
五、禁用并重置Windows功能中的.NET Framework开关
Windows功能列表中启用/禁用.NET Framework会修改系统组件状态，若切换过程异常，可能导致运行时加载失败，需强制同步功能开关与实际安装状态。
1、按Win+R输入optionalfeatures.exe，打开“Windows功能”窗口。
2、取消勾选“.NET Framework 3.5（包括.NET 2.0和3.0）”与“.NET Framework 4.8 Advanced Services”（依实际版本调整）。
3、点击确定，等待系统关闭功能并重启。
4、再次打开该窗口，重新勾选上述两项，点击确定，系统将触发自动下载与重安装流程。
