如何用WinSCP结合.NET比对FTP本地远程文件并检查更新

阿华AIGC实验室

2026-5-14

解决方案：用WinSCP在.NET中检查FTP服务器更新并实现更新逻辑

首先，你的核心需求是检查FTP服务器上是否有比本地新的文件更新，然后根据结果提示用户并执行更新。当前你用了SynchronizationMode.Local（将远程目录同步到本地），我们可以基于这个逻辑扩展出更新检查和交互逻辑。

关键思路

调用SynchronizeDirectories后，SynchronizationResult对象会包含所有需要同步的文件差异。我们可以通过检查这些差异来判断是否存在更新：

如果差异集合不为空，说明有需要同步的文件（即有更新）
之后可以根据用户选择执行同步，或者取消

修改后的完整代码示例

using WinSCP;
using System.Windows.Forms; // 注意要引用Windows Forms程序集，WPF项目请改用System.Windows.MessageBox

// 配置FTP会话参数
SessionOptions sessionOptions = new SessionOptions
{
    Protocol = Protocol.Ftp,
    HostName = ftp_url,
    UserName = username,
    Password = pass
};

using (Session session = new Session())
{
    // 注册你已有的事件监听
    session.FileTransferred += FileTransferred;
    session.FileTransferProgress += SessionProgressBar;

    try
    {
        session.Open(sessionOptions);
        rtb_update_material.AppendText("\n已连接到FTP服务器\n");

        // 第一步：仅检查差异，不实际同步
        SynchronizationResult syncPreviewResult = session.SynchronizeDirectories(
            SynchronizationMode.Local, 
            @"MyPath\", 
            "/", 
            mirror: true, // 若不需要删除本地多余文件，设为false
            synchronizeDirectories: true,
            preview: true // 关键：开启预览模式，仅分析文件差异
        );

        // 判断是否存在更新
        if (syncPreviewResult.Differences.Count > 0)
        {
            DialogResult userChoice = MessageBox.Show("检测到可用更新，是否立即更新？", "更新提示", MessageBoxButtons.OKCancel);
            if (userChoice == DialogResult.OK)
            {
                // 第二步：执行实际同步更新
                SynchronizationResult syncResult = session.SynchronizeDirectories(
                    SynchronizationMode.Local, 
                    @"MyPath\", 
                    "/", 
                    mirror: true
                );
                syncResult.Check(); // 检查同步是否成功，失败会抛出异常

                if (syncResult.IsSuccess)
                {
                    rtb_update_material.AppendText("\n更新完成！\n");
                    MessageBox.Show("更新已成功完成！");
                }
            }
            else
            {
                rtb_update_material.AppendText("\n用户取消了更新\n");
                return;
            }
        }
        else
        {
            rtb_update_material.AppendText("\n当前已是最新版本，无需更新\n");
            return;
        }
    }
    catch (Exception ex)
    {
        rtb_update_material.AppendText($"\n操作出错：{ex.Message}\n");
        MessageBox.Show($"更新过程中出现错误：{ex.Message}");
    }
}

代码关键点解释

预览模式检查差异：
- 第一次调用SynchronizeDirectories时设置preview: true，这会只分析本地与远程的文件差异，不实际传输文件，能快速判断是否有更新。
- 通过syncPreviewResult.Differences.Count判断是否存在需要同步的文件。
用户交互与实际更新：
- 检测到更新后弹出提示框，让用户选择是否执行更新。
- 用户确认后，再次调用SynchronizeDirectories（关闭预览模式），执行实际的同步操作。
错误处理：
- 加入try-catch块捕获FTP连接、文件传输等可能出现的异常，提升程序稳定性。