WinUI3 C#应用修改指定注册表项未同步至注册表编辑器的问题

问题 #

在空白WinUI3应用中，尝试修改注册表项HKEY_CURRENT_USER\Control Panel\Desktop\WindowMetrics\IconSpacing的值。代码执行后调试输出显示，首次运行时原值为-1128，修改后变为-1129，重启应用后该值保留，但注册表编辑器始终显示原值-1128。

代码如下：

RegistryKey windowMetricsKey = Registry.CurrentUser.OpenSubKey("Control Panel\\Desktop\\WindowMetrics", true);
Debug.WriteLine(windowMetricsKey.GetValue("IconSpacing")); // -1128 (仅首次运行显示，之后为-1129)
windowMetricsKey.SetValue("IconSpacing", "-1129");
Debug.WriteLine(windowMetricsKey.GetValue("IconSpacing")); // -1129

重启系统无效果，尝试直接使用HKEY_USERS/{ Session Id }替代HKEY_CURRENT_USER，结果相同。卸载重装应用后，首次运行仍会读取原值-1128，修改后调试显示为-1129，但注册表编辑器依旧无变化。

请问：为何注册表项未被更新？我实际修改的是什么？能否修改真实的HKEY_CURRENT_USER，该如何操作？

系统信息：

• Windows 10 Pro 22H2（版本19045.2364）
• Windows Feature Experience Pack 120.2212.4190.0
• Visual Studio 2022（版本17.4.3）
• 最新WinUI3（Windows App SDK 1.2）

原因与解决方法 #

1. 注册表无更新的原因及实际修改对象 #

WinUI3应用（基于Windows App SDK）默认运行在MSIX容器内，系统会为这类应用创建独立的注册表虚拟化环境。你代码中读写的HKEY_CURRENT_USER并非真实系统的注册表项，而是应用专属的虚拟副本。

这个虚拟副本仅对当前应用可见，修改后只有你的应用能读取到变更值，系统注册表编辑器、其他应用都无法感知；卸载应用时虚拟注册表会被清除，所以重装后首次运行会重新读取真实注册表的原值。

2. 修改真实HKEY_CURRENT_USER的方法 #

可以实现，但需要调整应用的权限配置，步骤如下：

• 打开项目中的Package.appxmanifest文件，右键选择「查看代码」。
• 在<Package>节点中添加命名空间声明：

  xmlns:rescap="http://schemas.microsoft.com/appx/manifest/foundation/windows10/restrictedcapabilities"
  IgnorableNamespaces="uap mp rescap"
  

• 在<Capabilities>节点内添加注册表读写的受限权限：

  <rescap:Capability Name="registryReadWriteAll" />
  

• 注意：registryReadWriteAll是受限权限，使用该权限的应用无法提交至Microsoft Store，仅适用于企业内部部署或侧加载场景；同时应用需要以管理员权限运行，否则仍无法修改系统敏感注册表项。

内容的提问来源于stack exchange，提问作者Sams