Epic Games启动器无法识别已安装的引擎版本

Question

Epic Games启动器无法识别已安装的引擎版本，常见于用户手动迁移或自定义路径安装Unreal Engine后。启动器无法正确读取注册表或LocalBuilds.json配置文件中的安装信息，导致引擎列表为空或显示“安装”而非“启动”。此问题多因权限不足、安装路径包含中文或特殊字符、启动器缓存异常所致。建议检查安装目录权限，确保路径为英文且符合默认结构，并尝试重启启动器或重建安装注册信息以恢复识别。

Answer 1

一、问题现象与初步诊断

Epic Games启动器无法识别已安装的Unreal Engine版本，是许多开发者在迁移项目或自定义安装路径后常遇到的问题。典型表现为引擎列表为空，或原本应显示“启动”的按钮仍为“安装”状态。

• 用户手动将UE引擎从默认路径（如 C:\Program Files\Epic Games\...）迁移至其他磁盘或目录
• 安装路径中包含中文字符或特殊符号（如空格、括号、&等）
• 操作系统权限限制导致Epic启动器无法读取注册表项或配置文件
• LocalBuilds.json 文件未正确更新或丢失关键信息
• 启动器本地缓存损坏或未及时刷新已安装实例的状态

二、核心机制解析：Epic如何识别已安装引擎

理解Epic Games启动器的识别逻辑是解决问题的关键。其主要依赖以下两个系统级组件：

组件	作用位置	说明
注册表键值	HKEY_LOCAL_MACHINE\SOFTWARE\EpicGames\Unreal Engine	存储全局安装路径和版本映射关系
LocalBuilds.json	%LOCALAPPDATA%\EpicGamesLauncher\Saved\Config\Windows\	记录本地构建信息，包括版本号、路径、状态等
EngineInstallation.ini	同上Config目录	辅助配置文件，用于维护多版本共存时的元数据

三、深度排查流程图

    ```mermaid
    graph TD
        A[启动器不识别UE版本] --> B{检查安装路径}
        B -->|含中文/特殊字符| C[重命名路径为纯英文]
        B -->|路径正常| D[验证文件夹权限]
        D --> E[确保当前用户具有读写权限]
        E --> F[定位LocalBuilds.json]
        F --> G{文件是否存在且结构完整?}
        G -->|否| H[重建LocalBuilds.json]
        G -->|是| I[比对其中InstallLocation字段]
        I --> J[是否指向实际安装路径?]
        J -->|否| K[修改为正确路径]
        J -->|是| L[清除启动器缓存]
        L --> M[重启Epic启动器]
        M --> N[问题是否解决?]
        N -->|否| O[手动注册到注册表]
        O --> P[使用reg add命令注入版本信息]
        P --> Q[完成]
    ```
    

四、解决方案层级递进

1. 基础层：路径与权限校验
   • 确保所有UE安装路径为全英文，不含空格或特殊字符（推荐格式：D:\UE_Engine\UE_5.3）
   • 右键安装目录 → 属性 → 安全 → 编辑 → 添加当前用户并赋予“完全控制”权限
2. 中间层：配置文件修复
   • 打开路径：%LOCALAPPDATA%\EpicGamesLauncher\Saved\Config\Windows\
   • 备份并编辑 LocalBuilds.json，确认存在如下结构片段：

     {
       "InstallationList": [
         {
           "BuildVersion": "5.3",
           "EngineVersion": "5.3.2",
           "InstallLocation": "D:\\UE_Engine\\UE_5.3",
           "IsMod": false,
           "IsSourceDistribution": false
         }
       ]
     }

3. 高级层：注册表干预
   • 运行 regedit，导航至 HKEY_LOCAL_MACHINE\SOFTWARE\EpicGames\Unreal Engine
   • 若不存在，可手动创建，并添加字符串值 4.0 或 5.3 指向安装根目录
   • 命令行快速注入示例：

     reg add "HKEY_LOCAL_MACHINE\SOFTWARE\EpicGames\Unreal Engine" /v "5.3" /t REG_SZ /d "D:\UE_Engine\UE_5.3" /f

4. 终极手段：重建启动器状态
   • 关闭Epic启动器
   • 删除整个 %LOCALAPPDATA%\EpicGamesLauncher\Saved 目录
   • 重新启动Epic客户端，触发首次初始化流程，自动扫描现有安装