marmoset toolbag 八猴 兼容性

1. 确认系统版本和位数是否满足要求
   Marmoset Toolbag 对 Windows 系统有版本要求，建议使用 Windows 10 或 Windows 11 的 64 位系统。如果当前系统是 32 位版本，软件将无法运行。右键「此电脑」选择「属性」，在「系统」栏查看系统类型标注的是「64 位操作系统」还是「32 位操作系统」。若系统版本过低（如 Windows 7 或更早版本），可能存在 API 兼容性问题，建议升级系统后再尝试运行八猴。
2. 以管理员身份运行程序
   某些情况下普通用户权限会导致程序无法正常加载必要的文件，从而出现兼容性问题。右键桌面或开始菜单中的 Marmoset Toolbag 快捷方式，选择「以管理员身份运行」。如果是通过 Steam 安装的版本，同样在 Steam 库中右键游戏，选择「以管理员身份启动」。长期使用时可右键快捷方式，进入「属性」-「兼容性」选项卡，勾选「以管理员身份运行此程序」，这样每次启动都会自动获取最高权限，避免因权限不足导致的兼容性问题。
3. 设置 Windows 兼容模式
   如果软件在当前系统上启动异常但无明确报错，可尝试手动设置兼容模式。右键程序或快捷方式，选择「属性」-「兼容性」选项卡，勾选「以兼容模式运行此程序」，然后在下拉菜单中选择较新的 Windows 版本（如 Windows 10 或 Windows 11）。同时可以勾选「简化的颜色模式」尝试 8 位颜色选项，看是否能绕过显卡驱动的兼容性问题。兼容模式会指示程序使用旧版系统调用，对部分显卡驱动不完全兼容的情况有一定缓解作用。
4. 更新显卡驱动程序
   显卡驱动是影响 Marmoset Toolbag 兼容性和稳定性的关键因素。打开设备管理器，展开「显示适配器」，右键显卡名称选择「更新驱动程序」，选择「自动搜索更新的驱动程序软件」。如果系统自带的驱动更新无效，建议前往 NVIDIA、AMD 或 Intel 官网下载对应显卡型号的最新驱动程序。旧版显卡驱动可能导致 OpenGL 或 Direct3D 初始化失败，表现为程序黑屏、闪退或卡在启动界面。更新驱动后重启电脑再尝试运行八猴。
5. 检查运行库和系统组件完整性
   Marmoset Toolbag 依赖 Microsoft Visual C++ 运行库和 DirectX 组件。如果运行库缺失或损坏，可能导致兼容性问题。使用系统自带的「程序和功能」检查是否安装了 Visual C++ Redistributable，若有缺失可前往微软官网下载安装 Visual C++ 2015-2022 Redistributable。同时运行「dxdiag」命令检查 DirectX 版本是否完整。在控制台输入「msdt.exe /id DirectXDiagnosticTool」或直接按 Win+R 输入 dxdiag 查看详情，确保 DirectX 12 已正确安装且无报错信息。
6. 将程序加入杀毒软件白名单
   部分杀毒软件会将 Marmoset Toolbag 的正常进程误判为风险程序并拦截其运行，导致兼容性问题。打开杀毒软件设置，找到「白名单」或「排除项」功能，将八猴的安装目录（通常为 C:Program FilesMarmosetToolbag 或 Steamsteamappscommonmarmoset）添加到信任区域。同时在杀毒软件的主防护记录中查看是否有被拦截的八猴相关进程，如有则恢复并放行。添加白名单后关闭杀毒软件实时防护的临时测试也能帮助判断是否是杀毒拦截导致的问题。
7. 关闭硬件加速和覆盖合成
   Windows 10/11 的硬件加速和覆盖合成功能可能与 Marmoset Toolbag 的渲染流程产生冲突，导致程序在启动或渲染时出现白屏、卡死现象。在 Windows 设置中进入「系统」-「屏幕」-「图形设置」，关闭「硬件加速的 GPU 调度」和「自动 HDR」。同时在显卡控制面板（如 NVIDIA 控制面板）中找到「管理 3D 设置」，将「平滑处理」设为「关」，「线程优化」设为「开」。关闭这些功能后重新启动八猴，观察兼容性问题是否得到解决。

软件页面：Marmoset Toolbag 八猴。