1. 项目概述：为什么你需要掌握这个配置文件？

如果你是刚接触虚幻引擎（UE4/UE5）的新手，在打包出第一个可执行程序后，大概率会遇到一个看似简单却让人头疼的问题：游戏启动时，它怎么不听使唤？你明明在编辑器里设置好了全屏，打包出来却是个小窗口；或者你想让它在窗口模式下启动方便调试，它却自顾自地全屏了。更麻烦的是，你翻遍了项目设置，好像也没找到一个能直接控制打包后启动状态的选项。这个问题的根源，就在于一个名为DefaultGameUserSettings.ini的配置文件。它就像一个游戏的“出厂设置”说明书，决定了你的游戏第一次在玩家电脑上运行时，应该以什么样的姿态呈现。

别小看这个文件，它直接关系到玩家的第一印象和基础体验。一个默认全屏的游戏可能让玩家误以为无法切换窗口；而一个默认窗口化的游戏，对于追求沉浸感的玩家来说又不够友好。手动去修改这个文件，对于开发者来说是基本功，对于玩家来说，也可以通过它来“调教”游戏，解决一些因显示设置不当导致的崩溃、黑屏或性能问题。网络上搜索“ue4 打包设置全屏”或“ue5 游戏启动窗口”的热度，恰恰说明了这是新手开发者普遍会踩的第一个坑。今天，我们就来彻底拆解这个文件，让你在3分钟内，从“一脸懵”到“完全掌控”。

2. DefaultGameUserSettings.ini 文件深度解析

2.1 文件定位与作用机制

首先，我们得搞清楚这个文件在哪，以及它是如何工作的。DefaultGameUserSettings.ini文件位于你项目的Config目录下（例如：YourProject/Config/）。它的核心作用是定义游戏的默认用户设置。请注意“默认”这个词——它只在游戏首次运行，或者用户设置文件（GameUserSettings.ini）不存在时生效。

当玩家启动你的打包游戏后，引擎会按以下顺序读取设置：

1. 检查用户目录：在%LOCALAPPDATA%\[YourGameCompany]\[YourGameName]\Saved\Config\Windows\路径下（以Windows为例）寻找GameUserSettings.ini。如果这个文件存在，说明玩家已经运行过游戏并可能更改过设置（如分辨率、图形质量），引擎会优先使用这里的配置。
2. 回退到默认配置：如果上述用户设置文件不存在（即第一次运行），引擎就会回退到项目Config文件夹下的DefaultGameUserSettings.ini，并依据其内容来初始化游戏窗口。
3. 保存用户设置：游戏运行后，玩家通过游戏内的选项菜单进行的任何更改（比如切换全屏、调整分辨率），都会被实时保存到用户目录的GameUserSettings.ini中，覆盖默认行为。这就是为什么你改了Default文件，但对已经运行过的游戏不起作用的原因。

所以，DefaultGameUserSettings.ini是你为所有新玩家设定的“第一印象”，而用户目录下的那个文件，则是每位玩家个性化的游戏设置存档。

2.2 核心参数拆解与含义

打开DefaultGameUserSettings.ini，你会看到一个[/Script/Engine.GameUserSettings]的段落下，包含了一系列键值对。我们重点关注控制窗口模式的几个核心参数：

[/Script/Engine.GameUserSettings] bUseDesiredScreenHeight=False bUseDesiredScreenWidth=False DesiredScreenHeight=1080 DesiredScreenWidth=1920 FullscreenMode=1 LastConfirmedFullscreenMode=1 PreferredFullscreenMode=1 ResolutionSizeX=1920 ResolutionSizeY=1080 WindowPosX=-1 WindowPosY=-1

我们来逐一解读：

• FullscreenMode：这是最核心的参数，控制游戏启动时的显示模式。
  • 0：全屏独占模式。游戏独占显卡输出，通常能获得最佳性能，但切换回桌面（Alt+Tab）可能有延迟或黑屏。
  • 1：窗口化全屏模式。也称为“无边框窗口全屏”。游戏窗口覆盖整个屏幕，但没有独占显卡，Alt+Tab切换更流畅，是多任务玩家的最爱。这也是很多现代游戏的默认推荐模式。
  • 2：窗口化模式。游戏在一个可拖动、可调整大小的标准窗口中运行。
• LastConfirmedFullscreenMode&PreferredFullscreenMode：这两个参数通常作为备份或偏好记录，在大多数情况下，你只需要确保它们和FullscreenMode的值保持一致即可，避免引擎内部逻辑冲突。
• ResolutionSizeX与ResolutionSizeY：这定义了游戏渲染的内部分辨率。注意，在窗口化模式下，它也决定了窗口客户区的大小。
• DesiredScreenWidth/Height与bUseDesiredScreenWidth/Height：这一组参数用于指定“期望的”屏幕分辨率。当bUseDesiredScreenHeight/Width设置为True时，引擎会尝试将游戏分辨率设置为Desired的值。但根据我的经验，对于简单的全屏/窗口控制，直接使用ResolutionSizeX/Y和FullscreenMode更直接可靠，这一组参数有时行为不太直观，新手可以暂时忽略或保持为False。
• WindowPosX和WindowPosY：指定窗口在屏幕上的初始位置。-1通常代表“居中显示”。你可以设置为0来贴靠屏幕左上角。

注意：网上有些教程可能会提到ScreenResolution参数，但在标准的GameUserSettings类中，控制分辨率的主要是ResolutionSizeX/Y。确保你修改的是正确的参数名。

3. 3分钟实操：一键切换全屏与窗口模式配置

理解了原理，操作就非常简单了。下面我们分场景进行配置。

3.1 场景一：打包时即固定启动模式（推荐给开发者）

这是作为项目开发者的你，最应该配置好的地方。你希望游戏打包出来后，所有新玩家第一次启动时，都按照你设定的模式运行。

操作步骤：

1. 在你的UE4/UE5项目根目录下，找到Config文件夹。

2. 用任何文本编辑器（如记事本、VS Code、Notepad++）打开DefaultGameUserSettings.ini文件。如果该文件不存在，就新建一个。

3. 确保文件中有[/Script/Engine.GameUserSettings]这个段落头。如果没有，就手动添加在第一行。

4. 在该段落下，添加或修改以下关键行：

   目标A：设置为窗口化全屏模式启动（现代游戏常用）

   [/Script/Engine.GameUserSettings] FullscreenMode=1 LastConfirmedFullscreenMode=1 PreferredFullscreenMode=1 ResolutionSizeX=1920 ResolutionSizeY=1080

   目标B：设置为经典全屏独占模式启动

   [/Script/Engine.GameUserSettings] FullscreenMode=0 LastConfirmedFullscreenMode=0 PreferredFullscreenMode=0 ResolutionSizeX=1920 ResolutionSizeY=1080

   目标C：设置为窗口化模式启动（方便调试、截图）

   [/Script/Engine.GameUserSettings] FullscreenMode=2 LastConfirmedFullscreenMode=2 PreferredFullscreenMode=2 ResolutionSizeX=1280 ResolutionSizeY=720 WindowPosX=-1 WindowPosY=-1

   这里我把分辨率调小了，因为窗口模式通常不需要占用整个屏幕那么大的渲染区域。

5. 保存文件。

6. 关键一步：在虚幻编辑器内，打开“项目设置”（Project Settings），在“打包”（Packaging）设置中，找到“配置”（Configuration）下拉菜单，确保你选择的是“Shipping”或“Development”等与你打包目标一致的配置。然后，执行打包操作。打包器会自动将这个DefaultGameUserSettings.ini文件包含进游戏的Config目录。

实操心得：

• 我强烈建议在开发期将默认模式设置为“窗口化全屏”（FullscreenMode=1）。这样既能获得接近全屏的体验，又方便你随时Alt+Tab切换出来查看日志、调试器或浏览器，效率极高。
• 在打包最终发布版本前，再根据游戏类型决定。对于沉浸式3A大作，可能用0（全屏独占）；对于独立游戏或偏重策略、模拟类的游戏，1（窗口化全屏）是更安全、兼容性更好的选择。

3.2 场景二：为已分发的游戏创建配置补丁（面向玩家或运维）

假设游戏已经分发出去，玩家遇到了启动问题，或者你想提供一个“窗口化启动补丁”。你不能直接修改玩家电脑上的用户设置文件（因为可能不存在或已被修改），但可以指导玩家替换默认配置文件。

操作步骤：

1. 你作为开发者，按照3.1的步骤，创建一个配置好的DefaultGameUserSettings.ini文件。
2. 将这个文件单独压缩，制作成一个简单的“配置修正包”。
3. 提供清晰的说明文档，告诉玩家：将压缩包内的DefaultGameUserSettings.ini文件，解压到游戏安装目录下的[GameName]/[GameName]/Config/文件夹中（注意，通常是两层游戏名目录），覆盖原文件（如果有的话）。
4. 强调：这只对首次运行的新玩家，或者删除了原有用户设置文件的玩家有效。对于已经生成过GameUserSettings.ini的玩家，需要先删除用户目录下的那个文件（路径见2.1），再启动游戏，才会应用新的默认设置。

玩家端简易排查流程： 如果玩家遇到游戏启动黑屏、崩溃在全屏切换时，或者单纯想强制窗口化启动，可以引导他们：

1. 找到游戏用户设置文件：%LOCALAPPDATA%\[GameCompany]\[GameName]\Saved\Config\Windows\GameUserSettings.ini。
2. 安全地备份或直接删除该文件。
3. 将你提供的、配置为窗口模式（FullscreenMode=2）的DefaultGameUserSettings.ini放到游戏Config目录。
4. 重新启动游戏。此时游戏会读取你提供的默认配置，以窗口模式安全启动。

3.3 场景三：通过命令行参数动态覆盖（高级用法）

对于测试人员或高级玩家，还有一种更灵活的方式：使用命令行参数。在游戏的快捷方式“目标”一栏，或通过启动器、命令行直接传递参数，可以覆盖配置文件的设置。

常用参数示例：

• -windowed：以窗口模式启动。
• -fullscreen：以全屏独占模式启动。
• -ResX=1280 -ResY=720：设置启动分辨率为1280x720。
• -WinX=100 -WinY=100：设置窗口启动位置。

例如，一个完整的快捷方式目标可能看起来像这样：

"D:\Games\MyGame\MyGame.exe" -windowed -ResX=1600 -ResY=900

这种方式优先级很高，非常适合自动化测试、快速切换不同显示配置的场景。

4. 常见问题、疑难杂症与深度排查

即使配置正确，你可能还是会遇到一些奇怪的问题。这里记录了几个我踩过的坑和解决方案。

4.1 问题一：修改了Default文件，但打包后游戏启动模式没变？

可能原因与排查：

1. 缓存未更新：虚幻引擎的打包过程有缓存机制。尝试在打包前，清理一下项目的中介目录（Intermediate）和保存目录（Saved），特别是Saved\Cooked和Saved\StagedBuilds，然后重新打包。
2. 配置文件未正确包含：检查打包后的游戏目录[GameName]/[GameName]/Config/下，是否存在你修改的DefaultGameUserSettings.ini文件，并用文本编辑器打开确认内容是否正确。有时文件可能因为版本控制或只读属性未能成功更新。
3. 存在用户设置文件：你是在自己的开发机上测试，而你的用户目录下早已存在GameUserSettings.ini。请按照2.1的路径找到并临时重命名或删除它，再测试打包版游戏。
4. 项目设置覆盖：极少数情况下，项目设置中的某些蓝图或C++代码可能会在游戏初始化时硬编码覆盖显示模式。检查你的游戏模式（GameMode）或玩家控制器（PlayerController）的初始化事件中，是否有调用SetFullscreenMode或类似功能的节点/代码。

4.2 问题二：游戏在全屏和窗口模式间切换时崩溃、黑屏或闪烁

可能原因与排查：

1. 显卡驱动问题：这是最常见的原因。确保你的显卡驱动是最新稳定版，尤其是NVIDIA/AMD的显卡。旧驱动对现代图形API（DX12, Vulkan）和无边框全屏模式的支持可能有问题。
2. 分辨率或刷新率不匹配：DefaultGameUserSettings.ini中设置的ResolutionSizeX/Y是否超出了显示器支持的范围？或者，你是否在代码中尝试切换到一个显示器不支持的分辨率？在全屏模式下，尝试切换到一个无效分辨率会导致黑屏或驱动超时恢复。建议在切换前，通过UKismetSystemLibrary::GetSupportedFullscreenResolutions等节点获取系统支持的分辨率列表。
3. 多显示器（外接设备）问题：当系统连接了多个显示器，且显示器之间的分辨率、缩放比例或刷新率不同时，全屏切换容易出问题。网络热词中提到的“ue4外接设备映射”相关的问题也常源于此。一个稳妥的做法是，在切换全屏前，先获取当前窗口所在的显示器信息，并针对该显示器设置合适的分辨率。
4. 引擎内部状态冲突：确保FullscreenMode、LastConfirmedFullscreenMode、PreferredFullscreenMode三个值在配置文件中保持一致。不一致可能导致引擎内部逻辑混乱。

4.3 问题三：如何让游戏记住玩家的选择，而不是每次启动都读Default？

这其实不是问题，而是引擎的正常机制。正如第2章所述，玩家在游戏内选项菜单的修改，会自动保存到用户目录的GameUserSettings.ini。你作为开发者，需要做的是确保你的游戏内设置菜单功能正常。

检查清单：

1. 你的设置菜单是否调用了正确的引擎接口？在蓝图中，通常使用GetGameUserSettings节点获取设置对象，修改其属性（如SetFullscreenMode、SetScreenResolution）后，务必调用ApplySettings和SaveSettings。
2. SaveSettings是否成功执行？这依赖于引擎是否有对Saved/Config目录的写入权限。对于安装在某些受保护的系统目录（如Program Files）下的游戏，可能需要以管理员权限运行，或者你的游戏应该将存档和配置设计在“我的文档”等有写入权限的位置。虚幻引擎默认的%LOCALAPPDATA%路径通常没有问题。
3. 如果你通过C++实现，确保在修改UGameUserSettings派生类的属性后，调用了ApplySettings(false)和SaveSettings()。

4.4 问题四：针对特定平台（如Windows特殊版本、虚拟机）的适配

从网络热词如“window7虚拟机安装后不是全屏”可以看出，特殊环境下的全屏问题很常见。

• Windows 7/8 或旧系统：对DX12和新的显示模式支持不完善。如果必须支持，考虑在DefaultGameUserSettings.ini中强制使用FullscreenMode=0（传统全屏）或2（窗口化），并提示玩家更新图形驱动。
• 虚拟机环境：VMware、VirtualBox等虚拟机的虚拟显卡驱动对全屏独占模式（FullscreenMode=0）支持很差，经常无法真正全屏或性能低下。在虚拟机中开发和测试时，务必使用窗口化模式（FullscreenMode=2）或窗口化全屏模式（FullscreenMode=1）。这也是为什么很多云桌面或远程开发环境推荐使用窗口模式的原因。
• 多显卡或核显/独显切换笔记本：确保游戏的可执行文件（.exe）在显卡控制面板中被设置为使用高性能GPU运行。有时游戏错误地运行在核显上，核显的性能和驱动支持可能导致全屏切换异常。

5. 进阶技巧：在蓝图与C++中动态控制显示模式

虽然配置文件决定了初始状态，但我们更常在游戏运行时动态切换。这里分享一些在蓝图和C++中操作的关键技巧。

5.1 蓝图实现：创建健壮的画面设置菜单

在蓝图中，创建一个典型的图形设置菜单，应遵循以下流程：

1. 获取设置对象：使用Get Game User Settings节点。
2. 获取当前/可选值：
   • 当前模式：从设置对象中获取Fullscreen Mode（是一个整数，对应0,1,2）。
   • 可选分辨率：使用Get Supported Screen Resolutions节点获取列表。这个节点返回的是一个Resolution结构体数组，包含Width和Height。注意：你需要将其转换为适合UI控件（如下拉菜单）显示的数据，通常提取为字符串数组（如“1920 x 1080”）。
3. 应用新设置：
   • 当玩家在下拉菜单中选择了新的显示模式或分辨率后，调用设置对象的Set Fullscreen Mode或Set Screen Resolution。
   • 重要：调用Apply Settings节点。这个节点有一个bCheckForCommandLineOverrides输入参数，通常保持为True，它会确保命令行参数优先级最高。
   • 最后，调用Save Settings将更改持久化到用户配置文件中。
4. UI反馈：在应用设置后，可以添加一个短暂的确认提示，或者像许多游戏那样，弹出一个“15秒内确认，否则恢复原设置”的对话框，因为分辨率/全屏切换可能导致显示异常。

避坑提示：在蓝图中处理分辨率列表时，直接使用Get Supported Screen Resolutions返回的数组绑定到UI，可能会导致UI显示混乱（因为包含了很多重复或非标准比例的分辨率）。最佳实践是写一个简单的函数来过滤这个列表，比如只保留16:9的常见分辨率，并去重，这样玩家的选择体验会好很多。

5.2 C++实现：更精细的控制与错误处理

在C++中，你可以获得更底层的控制权。以下是一个简单的示例，展示如何安全地切换全屏模式：

// 假设在某个UI按钮点击事件或游戏逻辑中 #include "GameFramework/GameUserSettings.h" void UYourWidget::OnFullscreenButtonClicked(int32 DesiredMode) { UGameUserSettings* UserSettings = GEngine->GetGameUserSettings(); if (!UserSettings) { UE_LOG(LogTemp, Error, TEXT("Failed to get GameUserSettings!")); return; } // 保存当前设置，以便切换失败时回滚 int32 CurrentMode = static_cast<int32>(UserSettings->GetFullscreenMode()); FIntPoint CurrentResolution = UserSettings->GetScreenResolution(); // 尝试应用新设置 UserSettings->SetFullscreenMode(static_cast<EWindowMode::Type>(DesiredMode)); // 如果你想同时改分辨率，可以在这里调用 SetScreenResolution // 应用设置，bCheckForCommandLineOverrides 设为 true bool bApplied = UserSettings->ApplySettings(false); // 这里传false，因为我们希望立即应用，不等待确认 if (!bApplied) { // 应用失败，回滚到之前的设置 UE_LOG(LogTemp, Warning, TEXT("Failed to apply new display settings. Rolling back.")); UserSettings->SetFullscreenMode(static_cast<EWindowMode::Type>(CurrentMode)); UserSettings->SetScreenResolution(CurrentResolution); UserSettings->ApplySettings(false); // 可以在这里给玩家一个UI提示，例如：“显示模式切换失败，请检查显卡驱动。” ShowErrorMessageToPlayer(TEXT("无法切换显示模式。")); } else { // 应用成功，保存设置 UserSettings->SaveSettings(); UE_LOG(LogTemp, Log, TEXT("Display settings changed and saved successfully.")); } }

C++进阶技巧：

• 你可以监听OnGameUserSettingsUINeedsUpdate委托，当显示设置因外部原因（如玩家按了Alt+Enter）改变时，及时更新你的UI状态。
• 对于多显示器支持，可以研究FDisplayMetrics和FSlateApplication相关的API，来获取更详细的显示器信息，实现“在全屏时选择显示器”这样的高级功能。

5.3 处理热键（如Alt+Enter）与引擎默认行为

虚幻引擎默认支持 Alt+Enter 快捷键在窗口化和全屏模式间切换。这个行为是由FWindowsApplication处理的。如果你想禁用或修改这个行为，需要深入到平台相关的代码层。对于大多数项目，保留这个默认行为对玩家是友好的。你需要确保你的游戏设置逻辑能与这个热键行为兼容——即玩家用热键切换后，你的设置菜单里的选项状态能同步更新。这通常依赖于UGameUserSettings内部状态的正确更新和广播。

6. 工程化实践：在团队与多配置环境中管理设置

对于稍大一点的团队项目，管理DefaultGameUserSettings.ini也需要一些技巧。

1. 版本控制：确保Config/DefaultGameUserSettings.ini文件被添加到版本控制系统（如Git、Perforce）中。但通常，Saved/目录下的用户个人设置文件应该被忽略。
2. 为不同构建配置使用不同设置：你可以在Config/目录下创建子目录，例如Config/Windows/、Config/WindowsEditor/、Config/WindowsServer/。引擎会根据运行平台和配置读取对应目录下的默认配置文件。更常见的做法是，在打包脚本或CI/CD流程中，动态替换Config/DefaultGameUserSettings.ini文件。例如，开发版打包使用窗口化模式方便测试，而发布版打包使用全屏模式。
3. 与项目设置联动：在“项目设置”->“引擎”-“常规设置”->“默认窗口模式”中，其实也有一个下拉选项。这个设置主要影响编辑器中的Play模式（PIE）的默认状态。它不会直接影响打包后的游戏启动模式。打包后的行为，最终还是由我们一直在讨论的DefaultGameUserSettings.ini文件决定。理解这一点可以避免混淆。
4. 自动化测试：如果你的项目有自动化测试框架，在测试启动时，可以通过命令行参数-windowed -ResX=800 -ResY=600强制指定窗口化和低分辨率，以保证测试环境的稳定性和一致性，同时不影响开发者的个人默认配置。

掌握DefaultGameUserSettings.ini的配置，远不止是改几个数字那么简单。它涉及到引擎的配置读取优先级、多环境适配、运行时动态控制以及异常处理等一系列知识。从最初级的修改配置文件，到在代码中健壮地处理显示切换，再到团队协作中的工程化管理，每一步都体现着对细节的掌控。希望这篇超详细的拆解，能让你彻底告别游戏启动显示模式的烦恼，把精力更多地投入到游戏内容本身的创作中去。