空洞骑士 Mod 装完就闪退Scarab 排错自救全指南【免费下载链接】ScarabAn installer for Hollow Knight mods written with Avalonia.项目地址: https://gitcode.com/gh_mirrors/sc/Scarab装好 Scarab勾上几个 Mod点下安装一切看起来顺风顺水——可一按启动《空洞骑士》当场闪退连标题画面都见不着。这正是 Hollow Knight 玩家在用 Scarab 管理 Mod 后最常撞上的那堵墙报错信息五花八门网上搜半天都对不上号。别慌这篇指南就是为你写的。Scarab 是专为《空洞骑士》打造的 Mod 安装与管理工具靠 Avalonia 框架构建界面清爽、操作简单但工具再顺手也绕不开版本对不对、路径准不准、文件全不全这三道坎。我们会像老手带你通关一样从最省事的检查一路排到最彻底的修复把崩溃问题一层层拆干净。先定位再动手问题速查表排错最忌上来就重装。先把你的现象和下面这张表对一对直接跳到对应小节省时省力。你看到的现象最可能的根子优先去看哪一节启动游戏秒闪退无任何提示API 与游戏版本不匹配或 Assembly-CSharp.dll 状态错乱环境与前置自检 / 清理重装游戏能进但 Mod 完全不生效Mod 文件没进对文件夹或依赖没装上清理重装Scarab 列表一片空白或反复报网络错数据源拉取失败走了备用 CDN 仍超时环境与前置自检Scarab 启动后找不到游戏游戏装了新盘符、换了路径自动检测失效环境与前置自检装某个 Mod 时报校验失败/Hash下载包损坏或网络代理篡改了文件清理重装 / 深度修复之前好好的换了系统或换平台后崩了平台切换导致 Mod 文件不兼容环境与前置自检看完表按顺序往下走每一层解决一类故障做完一层还不行再进入下一层。第一层环境与前置自检——最省事先做这一层解决的是方向性错误版本、路径、平台不对后面怎么重装都白搭。绝大多数装完就闪退都栽在这一层先花十分钟把这四项过一遍。核对游戏版本与 API 版本Mod 和 API 都是照着特定游戏版本编译的版本对不上游戏一加载就被内存布局差异干趴下。Scarab 每次启动都会去拉取最新的 Mod 清单和 API 清单并检查自身版本是否过时所以请先确认你用的是最新版 Scarab再确认 API 已更新到最新。判断方法很简单打开 Scarab找到 APIModding API这一项如果它的状态不是最新直接点更新。更新完再看 Mod 列表里有没有出现红色错误标记或版本警告——有就说明某个 Mod 依赖的版本对不上。确认安装路径找对了Scarab 会从 Steam 注册表、GOG 注册表、Steam 的libraryfolders.vdf以及常见默认路径里自动寻找游戏目录。但只要你把游戏装到了非默认盘符、手动移动过游戏文件夹、或刚重装过系统自动检测就可能落空此时 Scarab 会让你手动选择路径。请确认你选到的是这一层而不是更外层.../steamapps/common/Hollow Knight/hollow_knight_Data/Managed选错路径的典型后果Mod 装进了别的地方游戏自然毫无反应更糟的是把 API 装错目录直接闪退。选中后Scarab 会记住这个位置所以这一步值得认真核对一次。看一眼你的游戏平台Scarab 支持 Windows、macOS、Linux 三种平台同一款 Mod 在不同平台下可能是不同的文件。有个容易被忽略的场景Linux 玩家用 Proton 跑 Windows 版《空洞骑士》与跑原生 Linux 版所需文件完全不同。Scarab 在检测到平台变化时会自动强制重装 API 和带平台专属资源的 Mod。如果你在 Windows 和 Proton 之间来回切着玩记住一句话切平台之后让 Scarab 把 API 重装一遍别直接开游戏。确认数据源能正常拉取Scarab 启动时要拉两份清单ModLinks 和 ApiLinks主源超时三秒后自动切换备用 CDN。如果你网络环境特殊代理、防火墙、企业网络可能两份源都拉不下来表现为列表空白或弹网络错误框。处理办法先别急着怀疑工具坏了关掉代理试试确认能正常访问外网如果之前因为网络问题触发过兼容模式Scarab 会记住并自动使用备用客户端保持这个设置即可。这一层检查清单Scarab 是最新版本API 状态为最新无版本警告游戏路径指向hollow_knight_Data/Managed平台设置与当前运行环境一致尤其 Linux/Proton网络能正常拉取 Mod 清单如果到这里问题还没解决说明不是方向错了而是安装体本身脏了。请进入下一层我们做一次彻底的清理重装。第二层清理重装——把安装体推倒重建这一层解决文件状态错乱类故障装的 Mod 和记录对不上、残留文件冲突、下载包损坏。它的思路很朴素——旧的不去新的不来。先停用再卸载按依赖顺序来直接删游戏目录里的 Mod 文件夹是下策因为 Scarab 有一份独立的安装状态记录你手动删了文件夹记录却还在两边对不上界面状态就会乱。正确顺序是在 Scarab 里把全部已安装 Mod 停用停用只是移到 Disabled 文件夹不删文件很安全把 API 也停用让游戏恢复到原生状态确认游戏此时能正常启动——这一步能验证原生游戏没问题问题出在 Mod 层回到 Scarab逐个卸载 Mod再卸载 API重启一次电脑确保所有游戏进程彻底关干净卸载时留意依赖关系如果你装了 A、B 两个 ModA 依赖 B那么卸载 A 时只要没有其他 Mod 再依赖 BScarab 的自动移除依赖逻辑会把 B 一起清掉。别在 A 还装着的时候单独删 B那等于拆了承重墙。手工检查游戏目录里的三个关键文件API 的安装机制很巧妙它会把原版Assembly-CSharp.dll备份成.v后缀把打过补丁的版本作为当前生效文件停用 API 时再换回来。所以你可以在 Managed 目录下看到这三兄弟Assembly-CSharp.dll ← 当前生效的版本 Assembly-CSharp.dll.v ← 原版备份 Assembly-CSharp.dll.m ← Mod 版备份任何一次手动改名、误删、或非 Scarab 渠道的覆盖都会让这套互换机制失灵。停用 API 后游戏还闪退九成是.v备份缺失或损坏。如果发现.v不见了别手搓直接进入下一层的深度修复。重新安装这次一步一测清理干净后按下面的顺序装回来每装完一步都开一次游戏确认安装最新版 API启动游戏确认能进主菜单装第一个 Mod启动测试继续装下一个重复测试一次只装一个、装一个测一个是最笨也最可靠的方法——崩了崩的那个就是元凶。注意安装过程中如果弹出版本警告或依赖缺失提示别点忽略先解决再继续。这一层检查清单已停用所有 Mod 和 API且原生游戏能启动卸载时遵循依赖顺序未出现孤立依赖残留Assembly-CSharp.dll.v原版备份存在且未被改动重装按API → 单个 Mod → 测试的节奏推进下载过程无校验失败报错如果连原生状态都没法让游戏正常跑或 Scarab 自身都起不来了那问题已超出 Mod 层面进入第三层。第三层深度修复与日志分析——查状态、读日志、手动兜底这一层对付的是工具本身状态坏了配置文件损坏、记录文件被写乱、日志里藏着真实死因。做完这层还不行就可以带着日志去社区求助了。找到 Scarab 的三份关键文件Scarab 的所有状态都存在系统应用数据目录下的HKModInstaller文件夹里。Windows 上是%AppData%\HKModInstallerLinux 上是~/.config/HKModInstaller。里面有三样东西对应三种职能HKInstallerSettings.json ← 设置游戏路径、平台、主题、语言 InstalledMods.json ← 记录哪些 Mod 已安装、启用状态、API 版本 ModInstaller-20260815.log ← 日志按天滚动的运行记录InstalledMods.json是排错重灾区。如果它损坏比如异常断电写了一半Scarab 会尝试自愈重新扫描文件夹、把对不上的记录改回来、把缺失的 Mod 从记录里移除还会检查.m和当前 DLL 是否都在不在就把 API 标记为未安装。这套自愈逻辑已经很贴心但如果你手工改过文件夹结构最终状态可能和你预期不一致——这正是要看日志的原因。从日志里读出真实死因日志文件叫ModInstaller-*.log按天滚动一天一份。Scarab 会记录启动、路径检测、平台识别、下载、校验、安装、启停用的全过程。排查时按时间倒序打开最后一份搜索这几个关键词Fatal/Error异常与致命错误从这里开始看HashMismatch下载校验失败说明源文件与清单里的 SHA256 对不上重下或换网络Platform changed平台切换被触发API 和平台相关 Mod 会被强制重装missing文件缺失类警告比如原版备份丢了日志能告诉你事实发生了什么而不是你以为发生了什么。比如你觉得 Mod 装上了日志可能显示它被判定为缺失并移出了记录。手动兜底重建配置与状态如果配置本身坏到工具起不来可以手动兜底关闭 Scarab备份HKModInstaller整个文件夹到别处删除HKInstallerSettings.json和InstalledMods.json不要删日志那还要留着看重新启动 Scarab它会像全新安装一样让你重新选择游戏路径这一步的本质是让 Scarab 重新认识这个世界——路径你重新指状态它重新扫干干净净。如果连这一步都救不回来那就把日志和配置备份好带上它们去项目仓库提 issue信息越全别人越能帮你定位。这一层检查清单能定位到HKModInstaller目录读过最新的ModInstaller-*.log找过 Error 与 HashMismatch理解InstalledMods.json与磁盘文件夹的实际状态差异必要时已重置配置文件并重新指定游戏路径真实案例复盘三个崩了又修好的故事理论说一百遍不如看三个真实的翻车现场。案例一换硬盘后游戏找不到了场景小张把游戏从 C 盘迁到了 D 盘再开 Scarab弹窗要求重新选择路径他随手点了自动检测没成功索性一路点到底装了 Mod 进游戏毫无反应。排查过程打开设置确认路径时发现Scarab 记录的游戏路径还是 C 盘的老位置而 Mod 文件全被解压进了那个已不存在的目录链里。最终解决在 Scarab 里手动把路径改到 D 盘的Hollow Knight/hollow_knight_Data/Managed卸载全部 Mod 后重装一切恢复正常。经验提炼路径是 Scarab 的命根子。凡是移动过游戏、换过盘、重装过系统第一件事永远是核对路径别信印象里应该没错。案例二游戏自动更新后集体闪退场景莉莉的《空洞骑士》某天自动更新了再开游戏直接闪退所有 Mod 全失效。排查过程日志里没有任何 HashMismatch安装记录也正常。对照版本后确认游戏更新了新版本而 API 还是老版本二者内存布局对不上一加载就崩。最终解决打开 Scarab把 API 更新到与新版游戏匹配的版本再把之前标记为过时的 Mod 逐个更新问题解决。经验提炼游戏更新 一切推倒重来。别奢望 Mod 永远跟着游戏走更新后先升 API再升 Mod顺序不能反。案例三装了依赖 Mod 反而更崩场景阿杰装了一个需要前置库的 Mod提示说会自动带上依赖他一路确认结果游戏崩得比之前更厉害。排查过程Scarab 会自动启用依赖并递归处理依赖的依赖但阿杰这个前置库和另一个已装 Mod 是同一底层库的不同版本两个 Mod 的加载顺序又互不相让冲突叠冲突。最终解决全部停用确认原生游戏正常然后只装依赖库本身测试再装它依赖的另一个 Mod测试最后才装目标 Mod全程只留一个变量。经验提炼依赖处理是 Scarab 的强项但它只能保证装齐不能保证装对。冲突时别靠猜用排除法一个变量一个变量地测。防患于未然的守则三个时间节点与其事后救火不如从一开始就不让它烧起来。安装前确认游戏路径正确且目录有完整读写权限确认路径中不含中文、空格堆叠或特殊字符能避免绝大多数玄学问题关掉杀毒软件对游戏目录的实时监控或把目录加入白名单——防病毒误删 DLL 是闪退的隐形杀手备份存档。Mod 引发的存档损坏虽不常见但一次就够心疼使用中一次只装一个 Mod装完立刻开游戏验证依赖优先先 API再框架类 Mod最后装具体功能 Mod卸载 Mod 时交给 Scarab 做别手删文件夹让它维护状态一致性定期看一眼 Mod 列表把长期不更新的过时 Mod 停用掉更新后游戏更新后先升 API再升 Mod逐项确认切平台如 Windows ↔ Proton后让 Scarab 强制重装 API更新完进游戏前花三十秒确认所有 Mod 的依赖关系检查没有红色标记高频问题速答Q装完 Mod 游戏闪退但原生游戏能玩问题在哪A问题一定出在 Mod 层优先怀疑 API 版本或 Mod 文件状态按第二层的顺序全部停用再逐个启用。QScarab 显示安装成功游戏里却什么都没变A八成是路径错了Mod 装去了别的目录先去设置里核对路径再检查游戏是否以管理员权限运行。Q重装之后还是不行咋办A说明残留没清干净或配置已损坏进入第三层读日志、备份配置、重置状态文件。Q下载 Mod 时报校验失败是不是工具坏了A不是。是下载的文件与官方清单的 SHA256 对不上多半是网络或代理搞的鬼换网络重试即可。Q一个 Mod 崩了怎么确定就是它A全部停用然后逐个启用、逐个开游戏测谁启用后崩谁就是元凶再查它的依赖是否被别的 Mod 顶掉了。资源与深挖指引想进一步理解 Scarab 的运作机制可以直接看源码几个关键模块都标在这里读一遍你会对它更有底安装与卸载核心逻辑含 API 切换、SHA256 校验、依赖处理Scarab/Services/Installer.csMod 清单拉取与数据源备用机制Scarab/Services/ModDatabase.cs安装状态记录与自愈逻辑Scarab/Services/InstalledMods.cs游戏路径自动检测与平台识别Scarab/Settings.cs反向依赖搜索卸载前查谁还在依赖它Scarab/Services/ReverseDependencySearch.cs日志初始化与异常落盘Scarab/Program.cs想亲手跑起来或研究源码可以克隆仓库到本地再探索git clone https://gitcode.com/gh_mirrors/sc/Scarab排错的核心就一句话让 Scarab 看到的事实和磁盘上的事实保持一致。版本对、路径准、文件全你的《空洞骑士》就能安稳地装下整个 Mod 世界。记住这三点下次再闪退你已经有章法可循了。【免费下载链接】ScarabAn installer for Hollow Knight mods written with Avalonia.项目地址: https://gitcode.com/gh_mirrors/sc/Scarab创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 空洞骑士 Mod 装完就闪退？Scarab 排错自救全指南
空洞骑士 Mod 装完就闪退Scarab 排错自救全指南【免费下载链接】ScarabAn installer for Hollow Knight mods written with Avalonia.项目地址: https://gitcode.com/gh_mirrors/sc/Scarab装好 Scarab勾上几个 Mod点下安装一切看起来顺风顺水——可一按启动《空洞骑士》当场闪退连标题画面都见不着。这正是 Hollow Knight 玩家在用 Scarab 管理 Mod 后最常撞上的那堵墙报错信息五花八门网上搜半天都对不上号。别慌这篇指南就是为你写的。Scarab 是专为《空洞骑士》打造的 Mod 安装与管理工具靠 Avalonia 框架构建界面清爽、操作简单但工具再顺手也绕不开版本对不对、路径准不准、文件全不全这三道坎。我们会像老手带你通关一样从最省事的检查一路排到最彻底的修复把崩溃问题一层层拆干净。先定位再动手问题速查表排错最忌上来就重装。先把你的现象和下面这张表对一对直接跳到对应小节省时省力。你看到的现象最可能的根子优先去看哪一节启动游戏秒闪退无任何提示API 与游戏版本不匹配或 Assembly-CSharp.dll 状态错乱环境与前置自检 / 清理重装游戏能进但 Mod 完全不生效Mod 文件没进对文件夹或依赖没装上清理重装Scarab 列表一片空白或反复报网络错数据源拉取失败走了备用 CDN 仍超时环境与前置自检Scarab 启动后找不到游戏游戏装了新盘符、换了路径自动检测失效环境与前置自检装某个 Mod 时报校验失败/Hash下载包损坏或网络代理篡改了文件清理重装 / 深度修复之前好好的换了系统或换平台后崩了平台切换导致 Mod 文件不兼容环境与前置自检看完表按顺序往下走每一层解决一类故障做完一层还不行再进入下一层。第一层环境与前置自检——最省事先做这一层解决的是方向性错误版本、路径、平台不对后面怎么重装都白搭。绝大多数装完就闪退都栽在这一层先花十分钟把这四项过一遍。核对游戏版本与 API 版本Mod 和 API 都是照着特定游戏版本编译的版本对不上游戏一加载就被内存布局差异干趴下。Scarab 每次启动都会去拉取最新的 Mod 清单和 API 清单并检查自身版本是否过时所以请先确认你用的是最新版 Scarab再确认 API 已更新到最新。判断方法很简单打开 Scarab找到 APIModding API这一项如果它的状态不是最新直接点更新。更新完再看 Mod 列表里有没有出现红色错误标记或版本警告——有就说明某个 Mod 依赖的版本对不上。确认安装路径找对了Scarab 会从 Steam 注册表、GOG 注册表、Steam 的libraryfolders.vdf以及常见默认路径里自动寻找游戏目录。但只要你把游戏装到了非默认盘符、手动移动过游戏文件夹、或刚重装过系统自动检测就可能落空此时 Scarab 会让你手动选择路径。请确认你选到的是这一层而不是更外层.../steamapps/common/Hollow Knight/hollow_knight_Data/Managed选错路径的典型后果Mod 装进了别的地方游戏自然毫无反应更糟的是把 API 装错目录直接闪退。选中后Scarab 会记住这个位置所以这一步值得认真核对一次。看一眼你的游戏平台Scarab 支持 Windows、macOS、Linux 三种平台同一款 Mod 在不同平台下可能是不同的文件。有个容易被忽略的场景Linux 玩家用 Proton 跑 Windows 版《空洞骑士》与跑原生 Linux 版所需文件完全不同。Scarab 在检测到平台变化时会自动强制重装 API 和带平台专属资源的 Mod。如果你在 Windows 和 Proton 之间来回切着玩记住一句话切平台之后让 Scarab 把 API 重装一遍别直接开游戏。确认数据源能正常拉取Scarab 启动时要拉两份清单ModLinks 和 ApiLinks主源超时三秒后自动切换备用 CDN。如果你网络环境特殊代理、防火墙、企业网络可能两份源都拉不下来表现为列表空白或弹网络错误框。处理办法先别急着怀疑工具坏了关掉代理试试确认能正常访问外网如果之前因为网络问题触发过兼容模式Scarab 会记住并自动使用备用客户端保持这个设置即可。这一层检查清单Scarab 是最新版本API 状态为最新无版本警告游戏路径指向hollow_knight_Data/Managed平台设置与当前运行环境一致尤其 Linux/Proton网络能正常拉取 Mod 清单如果到这里问题还没解决说明不是方向错了而是安装体本身脏了。请进入下一层我们做一次彻底的清理重装。第二层清理重装——把安装体推倒重建这一层解决文件状态错乱类故障装的 Mod 和记录对不上、残留文件冲突、下载包损坏。它的思路很朴素——旧的不去新的不来。先停用再卸载按依赖顺序来直接删游戏目录里的 Mod 文件夹是下策因为 Scarab 有一份独立的安装状态记录你手动删了文件夹记录却还在两边对不上界面状态就会乱。正确顺序是在 Scarab 里把全部已安装 Mod 停用停用只是移到 Disabled 文件夹不删文件很安全把 API 也停用让游戏恢复到原生状态确认游戏此时能正常启动——这一步能验证原生游戏没问题问题出在 Mod 层回到 Scarab逐个卸载 Mod再卸载 API重启一次电脑确保所有游戏进程彻底关干净卸载时留意依赖关系如果你装了 A、B 两个 ModA 依赖 B那么卸载 A 时只要没有其他 Mod 再依赖 BScarab 的自动移除依赖逻辑会把 B 一起清掉。别在 A 还装着的时候单独删 B那等于拆了承重墙。手工检查游戏目录里的三个关键文件API 的安装机制很巧妙它会把原版Assembly-CSharp.dll备份成.v后缀把打过补丁的版本作为当前生效文件停用 API 时再换回来。所以你可以在 Managed 目录下看到这三兄弟Assembly-CSharp.dll ← 当前生效的版本 Assembly-CSharp.dll.v ← 原版备份 Assembly-CSharp.dll.m ← Mod 版备份任何一次手动改名、误删、或非 Scarab 渠道的覆盖都会让这套互换机制失灵。停用 API 后游戏还闪退九成是.v备份缺失或损坏。如果发现.v不见了别手搓直接进入下一层的深度修复。重新安装这次一步一测清理干净后按下面的顺序装回来每装完一步都开一次游戏确认安装最新版 API启动游戏确认能进主菜单装第一个 Mod启动测试继续装下一个重复测试一次只装一个、装一个测一个是最笨也最可靠的方法——崩了崩的那个就是元凶。注意安装过程中如果弹出版本警告或依赖缺失提示别点忽略先解决再继续。这一层检查清单已停用所有 Mod 和 API且原生游戏能启动卸载时遵循依赖顺序未出现孤立依赖残留Assembly-CSharp.dll.v原版备份存在且未被改动重装按API → 单个 Mod → 测试的节奏推进下载过程无校验失败报错如果连原生状态都没法让游戏正常跑或 Scarab 自身都起不来了那问题已超出 Mod 层面进入第三层。第三层深度修复与日志分析——查状态、读日志、手动兜底这一层对付的是工具本身状态坏了配置文件损坏、记录文件被写乱、日志里藏着真实死因。做完这层还不行就可以带着日志去社区求助了。找到 Scarab 的三份关键文件Scarab 的所有状态都存在系统应用数据目录下的HKModInstaller文件夹里。Windows 上是%AppData%\HKModInstallerLinux 上是~/.config/HKModInstaller。里面有三样东西对应三种职能HKInstallerSettings.json ← 设置游戏路径、平台、主题、语言 InstalledMods.json ← 记录哪些 Mod 已安装、启用状态、API 版本 ModInstaller-20260815.log ← 日志按天滚动的运行记录InstalledMods.json是排错重灾区。如果它损坏比如异常断电写了一半Scarab 会尝试自愈重新扫描文件夹、把对不上的记录改回来、把缺失的 Mod 从记录里移除还会检查.m和当前 DLL 是否都在不在就把 API 标记为未安装。这套自愈逻辑已经很贴心但如果你手工改过文件夹结构最终状态可能和你预期不一致——这正是要看日志的原因。从日志里读出真实死因日志文件叫ModInstaller-*.log按天滚动一天一份。Scarab 会记录启动、路径检测、平台识别、下载、校验、安装、启停用的全过程。排查时按时间倒序打开最后一份搜索这几个关键词Fatal/Error异常与致命错误从这里开始看HashMismatch下载校验失败说明源文件与清单里的 SHA256 对不上重下或换网络Platform changed平台切换被触发API 和平台相关 Mod 会被强制重装missing文件缺失类警告比如原版备份丢了日志能告诉你事实发生了什么而不是你以为发生了什么。比如你觉得 Mod 装上了日志可能显示它被判定为缺失并移出了记录。手动兜底重建配置与状态如果配置本身坏到工具起不来可以手动兜底关闭 Scarab备份HKModInstaller整个文件夹到别处删除HKInstallerSettings.json和InstalledMods.json不要删日志那还要留着看重新启动 Scarab它会像全新安装一样让你重新选择游戏路径这一步的本质是让 Scarab 重新认识这个世界——路径你重新指状态它重新扫干干净净。如果连这一步都救不回来那就把日志和配置备份好带上它们去项目仓库提 issue信息越全别人越能帮你定位。这一层检查清单能定位到HKModInstaller目录读过最新的ModInstaller-*.log找过 Error 与 HashMismatch理解InstalledMods.json与磁盘文件夹的实际状态差异必要时已重置配置文件并重新指定游戏路径真实案例复盘三个崩了又修好的故事理论说一百遍不如看三个真实的翻车现场。案例一换硬盘后游戏找不到了场景小张把游戏从 C 盘迁到了 D 盘再开 Scarab弹窗要求重新选择路径他随手点了自动检测没成功索性一路点到底装了 Mod 进游戏毫无反应。排查过程打开设置确认路径时发现Scarab 记录的游戏路径还是 C 盘的老位置而 Mod 文件全被解压进了那个已不存在的目录链里。最终解决在 Scarab 里手动把路径改到 D 盘的Hollow Knight/hollow_knight_Data/Managed卸载全部 Mod 后重装一切恢复正常。经验提炼路径是 Scarab 的命根子。凡是移动过游戏、换过盘、重装过系统第一件事永远是核对路径别信印象里应该没错。案例二游戏自动更新后集体闪退场景莉莉的《空洞骑士》某天自动更新了再开游戏直接闪退所有 Mod 全失效。排查过程日志里没有任何 HashMismatch安装记录也正常。对照版本后确认游戏更新了新版本而 API 还是老版本二者内存布局对不上一加载就崩。最终解决打开 Scarab把 API 更新到与新版游戏匹配的版本再把之前标记为过时的 Mod 逐个更新问题解决。经验提炼游戏更新 一切推倒重来。别奢望 Mod 永远跟着游戏走更新后先升 API再升 Mod顺序不能反。案例三装了依赖 Mod 反而更崩场景阿杰装了一个需要前置库的 Mod提示说会自动带上依赖他一路确认结果游戏崩得比之前更厉害。排查过程Scarab 会自动启用依赖并递归处理依赖的依赖但阿杰这个前置库和另一个已装 Mod 是同一底层库的不同版本两个 Mod 的加载顺序又互不相让冲突叠冲突。最终解决全部停用确认原生游戏正常然后只装依赖库本身测试再装它依赖的另一个 Mod测试最后才装目标 Mod全程只留一个变量。经验提炼依赖处理是 Scarab 的强项但它只能保证装齐不能保证装对。冲突时别靠猜用排除法一个变量一个变量地测。防患于未然的守则三个时间节点与其事后救火不如从一开始就不让它烧起来。安装前确认游戏路径正确且目录有完整读写权限确认路径中不含中文、空格堆叠或特殊字符能避免绝大多数玄学问题关掉杀毒软件对游戏目录的实时监控或把目录加入白名单——防病毒误删 DLL 是闪退的隐形杀手备份存档。Mod 引发的存档损坏虽不常见但一次就够心疼使用中一次只装一个 Mod装完立刻开游戏验证依赖优先先 API再框架类 Mod最后装具体功能 Mod卸载 Mod 时交给 Scarab 做别手删文件夹让它维护状态一致性定期看一眼 Mod 列表把长期不更新的过时 Mod 停用掉更新后游戏更新后先升 API再升 Mod逐项确认切平台如 Windows ↔ Proton后让 Scarab 强制重装 API更新完进游戏前花三十秒确认所有 Mod 的依赖关系检查没有红色标记高频问题速答Q装完 Mod 游戏闪退但原生游戏能玩问题在哪A问题一定出在 Mod 层优先怀疑 API 版本或 Mod 文件状态按第二层的顺序全部停用再逐个启用。QScarab 显示安装成功游戏里却什么都没变A八成是路径错了Mod 装去了别的目录先去设置里核对路径再检查游戏是否以管理员权限运行。Q重装之后还是不行咋办A说明残留没清干净或配置已损坏进入第三层读日志、备份配置、重置状态文件。Q下载 Mod 时报校验失败是不是工具坏了A不是。是下载的文件与官方清单的 SHA256 对不上多半是网络或代理搞的鬼换网络重试即可。Q一个 Mod 崩了怎么确定就是它A全部停用然后逐个启用、逐个开游戏测谁启用后崩谁就是元凶再查它的依赖是否被别的 Mod 顶掉了。资源与深挖指引想进一步理解 Scarab 的运作机制可以直接看源码几个关键模块都标在这里读一遍你会对它更有底安装与卸载核心逻辑含 API 切换、SHA256 校验、依赖处理Scarab/Services/Installer.csMod 清单拉取与数据源备用机制Scarab/Services/ModDatabase.cs安装状态记录与自愈逻辑Scarab/Services/InstalledMods.cs游戏路径自动检测与平台识别Scarab/Settings.cs反向依赖搜索卸载前查谁还在依赖它Scarab/Services/ReverseDependencySearch.cs日志初始化与异常落盘Scarab/Program.cs想亲手跑起来或研究源码可以克隆仓库到本地再探索git clone https://gitcode.com/gh_mirrors/sc/Scarab排错的核心就一句话让 Scarab 看到的事实和磁盘上的事实保持一致。版本对、路径准、文件全你的《空洞骑士》就能安稳地装下整个 Mod 世界。记住这三点下次再闪退你已经有章法可循了。【免费下载链接】ScarabAn installer for Hollow Knight mods written with Avalonia.项目地址: https://gitcode.com/gh_mirrors/sc/Scarab创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考