C# / WPF 实现软件开机自启动的深度指南：两种核心方案解析

在开发 Windows 桌面程序（如即时通讯、系统工具或监控软件）时，开机自启动是一项提升用户留存的关键功能。在 .NET 生态中，最常用的两种方案分别是：利用系统启动文件夹和修改注册表 Run 键值。

方案对比：哪种更适合你？

特性	方法一：启动文件夹 (Startup)	方法二：注册表 (Registry)
权限要求	普通用户权限即可	通常需要管理员权限 (HKLM)
用户可见性	用户在“启动”文件夹可见，易清理	较隐蔽，需在任务管理器或注册表查看
实现难度	中（需处理 COM 引用）	低（直接操作 RegistryKey）
推荐场景	绿色软件、普通客户端应用	系统级服务、后台常驻工具

方法一：通过快捷方式写入启动目录（无需管理员权限）

该方法通过在 Shell:Startup 目录创建 .lnk 文件实现。

1. 准备工作

需要引用 COM 组件：在项目中右键 -> 添加引用 -> COM -> 搜索并勾选 “Windows Script Host Object Model”（或安装 NuGet 包 IWshRuntimeLibrary）。

2. 核心代码实现

using System;
using System.IO;
using System.Linq;
using System.Diagnostics;
using IWshRuntimeLibrary; // 需要引用 COM

public class StartupFolderHelper
{
    private static string StartupPath => Environment.GetFolderPath(Environment.SpecialFolder.Startup);
    private static string AppPath => Process.GetCurrentProcess().MainModule.FileName;
    private static string AppName => Path.GetFileNameWithoutExtension(AppPath);

    /// <summary>
    /// 设置/取消开机自启动
    /// </summary>
    /// <param name="enable">是否启用</param>
    public static void SetAutoStart(bool enable)
    {
        string shortcutPath = Path.Combine(StartupPath, $"{AppName}.lnk");

        if (enable)
        {
            if (System.IO.File.Exists(shortcutPath)) return;

            WshShell shell = new WshShell();
            IWshShortcut shortcut = (IWshShortcut)shell.CreateShortcut(shortcutPath);
            shortcut.TargetPath = AppPath;
            shortcut.WorkingDirectory = AppDomain.CurrentDomain.BaseDirectory;
            shortcut.Description = $"Start {AppName} at Login";
            shortcut.Save();
        }
        else
        {
            if (System.IO.File.Exists(shortcutPath))
                System.IO.File.Delete(shortcutPath);
        }
    }
}

方法二：修改注册表 Run 项（更隐蔽、更专业）

这种方法将程序路径写入 HKEY_LOCAL_MACHINE 或 HKEY_CURRENT_USER 的 Run 节点中。

1. 权限说明

HKEY_CURRENT_USER (HKCU): 仅对当前用户生效，无需管理员权限。
HKEY_LOCAL_MACHINE (HKLM): 对全机用户生效，必须管理员权限。

2. 核心代码实现

using Microsoft.Win32;
using System.Diagnostics;

public class RegistryAutoStartHelper
{
    private const string RunKeyPath = @"SOFTWARE\Microsoft\Windows\CurrentVersion\Run";
    private static string AppName => Process.GetCurrentProcess().MainModule.ModuleName;
    private static string AppPath => Process.GetCurrentProcess().MainModule.FileName;

    public static bool SetAutoStart(bool enable)
    {
        try
        {
            // 建议优先使用 HKCU 以规避权限问题
            using (RegistryKey key = Registry.CurrentUser.OpenSubKey(RunKeyPath, true))
            {
                if (enable)
                    key.SetValue(AppName, $"\"{AppPath}\""); // 使用引号包裹路径防止空格路径解析错误
                else
                    key.DeleteValue(AppName, false);
            }
            return true;
        }
        catch (Exception ex)
        {
            Debug.WriteLine($"注册表操作失败: {ex.Message}");
            return false;
        }
    }
}

进阶技巧与踩坑指南

3.1 路径中的空格问题

在注册表中写入路径时，如果路径包含空格（如 C:\Program Files\MyApp.exe），务必用双引号包裹路径，否则 Windows 启动时可能无法正确识别可执行文件。

3.2 启动后的“起始目录”问题

程序开机启动时，其“当前工作目录”可能是 System32。在程序启动逻辑中，建议手动重置工作目录，否则读取配置文件会报错：

// 在 App.xaml.cs 或 Main 中调用
Directory.SetCurrentDirectory(AppDomain.CurrentDomain.BaseDirectory);

3.3 权限请求 (UAC)

如果你的程序需要写入 HKLM 注册表，需要在项目中添加 app.manifest 文件，并将权限级别改为：

<requestedExecutionLevel level="requireAdministrator" uiAccess="false" />

总结

如果你开发的是轻量级客户端，优先使用 HKCU 注册表 或 启动文件夹，避免触发 UAC 弹窗骚扰用户。
如果你开发的是企业级工具，建议通过安装包（MSI/Inno Setup）在安装阶段静默写入 HKLM 注册表。

在实施此功能时，请务必在软件设置界面提供明显的开关选项，尊重用户的选择权是良好交互设计的核心。