C#编辑HKEY_LOCAL_MACHINE注册表 VS调试正常发布exe后失效

你遇到的是.NET独立发布（尤其单文件模式）下Windows注册表访问的典型兼容问题，无报错但写入失效的核心原因有4个：

• Manifest未正确嵌入：调试模式下Visual Studio会自动读取项目中的app.manifest配置触发提权，但独立发布时若未在.csproj中显式指定manifest嵌入规则，最终生成的exe不会携带权限声明。此时Windows会通过兼容性启发式规则运行程序，即便你手动右键选择「以管理员身份运行」，也可能触发注册表虚拟化，写入操作被静默重定向到用户维度的VirtualStore路径，而非真正的HKLM全局注册表路径。
• 注册表视图隐式重定向：即使编译为64位程序，若未显式指定访问64位注册表视图，在部分Windows版本的WOW64兼容层逻辑下，写入操作会被重定向到HKLM\SOFTWARE\WOW6432Node\Microsoft\Windows\CurrentVersion\Run路径，你检查默认64位注册表路径时会发现值不存在。
• 注册表值未持久化：.NET的RegistryKey默认采用延迟写入机制，独立单文件程序执行速度快，部分.NET版本存在bug：依赖using块Dispose逻辑自动刷新注册表时，修改未被真正写入磁盘，程序退出后写入内容丢失，全程无异常抛出。
• 可执行文件路径取值错误：单文件发布的.NET程序运行时会将依赖解压到临时目录，若你通过Assembly.GetExecutingAssembly().Location或Environment.CurrentDirectory获取exe路径，拿到的是临时目录路径而非exe实际存储路径。即便注册表写入成功，重启时临时目录已被清理，自启失效，容易被误判为注册表未写入。

1. 确认发布配置正确 #

在项目的.csproj文件中添加如下配置，确保manifest被正确嵌入、平台目标匹配，从根源避免兼容性虚拟化和重定向问题：

<PropertyGroup>
  <!-- 替换为你实际使用的框架版本，如net48、net6.0-windows、net8.0-windows -->
  <TargetFramework>net8.0-windows</TargetFramework>
  <PlatformTarget>x64</PlatformTarget>
  <RuntimeIdentifier>win-x64</RuntimeIdentifier>
  <SelfContained>true</SelfContained>
  <PublishSingleFile>true</PublishSingleFile>
  <!-- 显式指定manifest嵌入，发布后生效 -->
  <ApplicationManifest>app.manifest</ApplicationManifest>
</PropertyGroup>

确认app.manifest中已配置管理员权限要求（你之前创建的manifest需包含以下节点）：

<trustInfo xmlns="urn:schemas-microsoft-com:asm.v2">
  <security>
    <requestedPrivileges xmlns="urn:schemas-microsoft-com:asm.v3">
      <requestedExecutionLevel level="requireAdministrator" uiAccess="false" />
    </requestedPrivileges>
  </security>
</trustInfo>

2. 修正注册表访问代码 #

代码中需要显式指定64位注册表视图、强制刷新写入、使用可靠API获取exe真实路径，修正后的代码如下：

using Microsoft.Win32;
using System.Diagnostics;

const string runKeyPath = @"SOFTWARE\Microsoft\Windows\CurrentVersion\Run";
const string appStartKey = "iOK2";
try
{
    // 显式打开64位视图的HKLM根键，彻底避免WOW64重定向
    using RegistryKey localMachine = RegistryKey.OpenBaseKey(RegistryHive.LocalMachine, RegistryView.Registry64);
    using RegistryKey? runKey = localMachine.OpenSubKey(runKeyPath, writable: true);
    
    if (runKey == null)
    {
        Console.WriteLine("注册表启动项路径访问失败");
        return;
    }

    // 可靠获取当前exe的真实绝对路径，兼容所有.NET版本和单文件发布模式
    string exePath = Path.Combine(AppContext.BaseDirectory, "iOK2.exe");
    // 写入启动项
    runKey.SetValue(appStartKey, exePath, RegistryValueKind.String);
    // 显式调用Flush强制持久化，避免延迟写入丢失
    runKey.Flush();

    // 写入后立即校验，提前发现异常
    var savedValue = runKey.GetValue(appStartKey)?.ToString();
    if (savedValue != exePath)
    {
        Console.WriteLine($"写入校验失败，预期路径：{exePath}，实际存储路径：{savedValue}");
    }
}
catch (UnauthorizedAccessException)
{
    Console.WriteLine("权限不足，请以管理员身份运行程序");
}
catch (Exception ex)
{
    Console.WriteLine($"启动项配置失败：{ex.Message}");
}

3. 额外排查项 #

• 临时关闭第三方安全软件的注册表防护功能，部分杀毒软件会静默拦截HKLM启动项的修改操作，无任何提示。
• 写入完成后直接打开注册表编辑器，定位到HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Run路径确认值存在，不要仅依赖代码读值判断，避免虚拟化路径干扰。

如果不想处理注册表兼容问题，可以直接调用Windows原生自带的schtasks.exe创建全局开机计划任务，不需要依赖PowerShell，稳定性更高，同样无需用户手动操作：

string exePath = Path.Combine(AppContext.BaseDirectory, "iOK2.exe");
// 创建面向所有用户、登录时自动启动、最高权限运行的计划任务
string taskArgs = $"/create /tn \"iOK2_AutoStart\" /ru \"Users\" /sc onlogon /tr \"\\\"{exePath}\\\"\" /rl highest /f";
Process.Start(new ProcessStartInfo("schtasks.exe", taskArgs)
{
    UseShellExecute = false,
    CreateNoWindow = true,
    WindowStyle = ProcessWindowStyle.Hidden
}).WaitForExit();

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