单实例应用Runtime接收命令行参数失败及单实例失效问题排查

一、单实例失效的核心原因 #

你肯定没开启项目的单实例模式：在Visual Studio里右键项目→属性→应用程序选项卡，必须勾选“使应用程序成为单实例应用程序”（英文是Make single instance application）。没开这个的话，StartupNextInstance事件根本不会触发，每次启动都会新建进程，自然单实例功能完全失效。

二、参数接收失败的常见问题 #

1. 参数获取错误：StartupNextInstanceEventArgs里的CommandLine属性才是新启动传入的参数，注意第一个元素是程序自身路径，必须跳过才能拿到真正的自定义参数，你可能直接传了空值或者没做过滤。
2. 窗体实例引用错误：在ApplicationEvents里调用Form1方法时，不能直接new Form1()，必须获取当前正在运行的主窗体实例——比如用Application.OpenForms.OfType<Form1>().FirstOrDefault()。要是新建实例，操作的是个看不见的新窗体，自然temp.txt不会有内容。
3. 文件写入权限问题：直接写d:\temp.txt可能被系统拦截（需要管理员权限），导致文件为空。可以换成用户目录下的路径测试，比如桌面路径。

三、正确实现示例 #

1. 先确认项目已开启单实例模式（步骤同上）。
2. ApplicationEvents里的事件处理代码：

private void MyApplication_StartupNextInstance(object sender, StartupNextInstanceEventArgs e)
{
    // 跳过程序自身路径，拿到真实参数
    var realArgs = e.CommandLine.Skip(1).ToArray();
    // 获取当前运行的主窗体
    var runningForm = Application.OpenForms.OfType<Form1>().FirstOrDefault();
    if(runningForm != null)
    {
        runningForm.NewArgumentsReceived(realArgs);
        // 可选：把主窗体调到前台
        runningForm.Activate();
    }
}

3. Form1里的参数处理方法：

public void NewArgumentsReceived(string[] args)
{
    // 用桌面路径避免权限问题
    string savePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Desktop), "temp.txt");
    File.WriteAllLines(savePath, args);
}

四、窗体任意位置读取参数的方案 #

在Form1里定义一个静态集合，收到新参数时更新，窗体其他地方直接访问即可：

public partial class Form1 : Form
{
    // 静态集合存当前参数，全窗体可访问
    public static List<string> CurrentRuntimeArgs { get; private set; } = new List<string>();

    public void NewArgumentsReceived(string[] args)
    {
        CurrentRuntimeArgs.Clear();
        CurrentRuntimeArgs.AddRange(args);
        // 调试写入文件
        string savePath = Path.Combine(Environment.GetFolderPath(Environment.SpecialFolder.Desktop), "temp.txt");
        File.WriteAllLines(savePath, args);
    }

    // 示例：按钮点击时读取参数
    private void btnShowArgs_Click(object sender, EventArgs e)
    {
        MessageBox.Show(string.Join("\n", CurrentRuntimeArgs));
    }
}

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