UE5在Mac上的编辑器个人项目设置（EditorPerProjectUserSettings.ini）的源码解读

在虚幻引擎5（UE5）中，配置文件（*.ini）扮演着极为重要的角色，它们用于定义和调整引擎以及应用程序的各种设置。特别地，MacEditorPerProjectUserSettings.ini 文件包含了许多编辑器和引擎“首选项”的默认值。这些首选项保存在用户的 /<Game>/Saved/Config/ 目录下的 EditorPerProjectUserSettings.ini 文件中。

EditorPerProjectUserSettings.ini文件

; -------------------------------------------------------------------------------------------------
; 重要：EditorPerProjectUserSettings.ini 有特殊的行为!
;
; 这个.ini文件包含了许多编辑器和引擎“首选项”的默认设置。这些首选项
; 被保存在用户的/<Game>/Saved/Config/目录下的EditorPerProjectUserSettings.ini文件中。
;
; 如果你在这里改变了一个首选项的默认值，那么这个改变不会自动
; 传播到已经有保存首选项的用户那里。我们的想法是必须保留
; 他们现有的设置，并且永远不想覆盖那个文件中的条目。
;
; 如果你添加了一个新的首选项，新的键和值将会传播到用户的
; EditorPerProjectUserSettings.ini文件。在我们加载用户现有设置之后，我们将合并
; 任何在这些默认设置中存在而在用户设置中缺失的键和值。
;
; 强制“重置”一个已经存在的首选项的一个简单技巧是简单地
; 重命名那个首选项的变量名。配置系统将其视为新添加的
; 键，并将改变传播到现有用户的首选项中。

; -------------------------------------------------------------------------------------------------
; IMPORTANT:  EditorPerProjectUserSettings.ini has special behavior!
;
; This .ini file contains the defaults for many editor and engine "preferences".  These preferences
; are saved to an EditorPerProjectUserSettings.ini file in the user's /<Game>/Saved/Config/ directory. 
;
; If you change the default for a preference in here, that change will *NOT* automatically 
; propagate to users who already have saved preferences.  The idea is that we must preserve
; their existing settings and never want to clobber entries in that file.
;
; If you add a new preference, the new key and value *WILL* be propagated to the user's
; EditorPerProjectUserSettings.ini file.  After we load the user's existing settings, we'll merge in
; any missing keys and values that are present in these defaults.
;
; One easy technique for forcing a "reset" of an already-existing preference is to simply
; rename the variable for that preference.  The config system will treat it as a newly-added
; key and will propagate the change to existing users' preferences.
; -------------------------------------------------------------------------------------------------
; -------------------------------------------------------------------------------------------------

[/Script/UnrealEd.EditorLoadingSavingSettings]
; 用于文本对比差异的工具
TextDiffToolPath=(FilePath="p4merge.app")

1. 特殊行为和用户设置

该文件具有特殊行为，主要在于如何处理用户首选项的默认值和用户已保存的首选项之间的关系。当更改此文件中的首选项默认值时，这些更改不会自动传播给已经保存了首选项的用户。这是为了保护用户现有的设置，并且永远不会覆盖该文件中的条目。

2. 新首选项的传播

如果添加了一个新的首选项，那么这个新的键和值将会被传播到用户的 EditorPerProjectUserSettings.ini 文件中。在加载用户现有设置后，系统将合并任何在这些默认设置中出现但用户设置中缺失的键和值。

3. 强制重置现有首选项

如果需要重置已经存在的首选项，一个简单的技巧是重命名该首选项的变量。配置系统将其视为新添加的键，并将更改传播到现有用户的首选项中。

4. 工具设置

此外，MacEditorPerProjectUserSettings.ini 文件还定义了一些工具设置，例如用于差异比较文本的工具。在给定的代码片段中，指定了文本比较工具的路径（例如Perforce的p4merge工具）。

5. 应用于Mac的特定设置

从文件名可以看出，这些设置特别针对Mac平台。这意味着虚幻引擎为不同平台提供了高度的可定制性，确保开发者可以为每个平台优化其工作流程。

结论

MacEditorPerProjectUserSettings.ini 文件是开发者在Mac平台上定制UE5编辑器环境的一个关键工具。通过理解和正确配置这些设置，可以提高工作效率并确保项目设置在团队中一致。此外，通过提供差异比较和其他工具的路径，开发者可以集成外部工具，进一步提高其生产力。这种灵活性和可扩展性是虚幻引擎作为一个强大游戏开发和内容创作平台的核心特性之一。