WinForms程序使用StreamWriter写文件时卡在foreach循环的问题

1. 解决延迟加载节点集合导致的遍历卡顿 #

HtmlAgilityPack的SelectNodes返回的是延迟枚举集合，遍历过程中可能因后台解析未完成卡住。先将结果转为List，提前把所有节点加载到内存：

var links = doc.DocumentNode.SelectNodes("//a[@href]")?.ToList() ?? new List<HtmlNode>();

2. 异步执行耗时操作，避免UI线程假死 #

WinForms中直接在UI线程做文件IO和HTML解析，会导致界面假死（看起来像代码卡住）。用Task.Run把逻辑放到后台线程：

private async void btnExtract_Click(object sender, EventArgs e)
{
    btnExtract.Enabled = false;
    try
    {
        await Task.Run(() =>
        {
            var doc = new HtmlDocument();
            doc.Load("test.html");
            var links = doc.DocumentNode.SelectNodes("//a[@href]")?.ToList() ?? new List<HtmlNode>();
            
            using (var writer = new StreamWriter("output.txt"))
            {
                foreach (var link in links)
                {
                    var href = link.GetAttributeValue("href", "");
                    if (!string.IsNullOrWhiteSpace(href))
                    {
                        writer.WriteLine(href);
                    }
                }
            }
        });
        MessageBox.Show("提取完成");
    }
    catch (Exception ex)
    {
        MessageBox.Show($"错误：{ex.Message}");
    }
    finally
    {
        btnExtract.Enabled = true;
    }
}

3. 确保文件资源正确释放 #

用using包裹StreamWriter，自动处理文件流的关闭与释放，无需手动调用Flush()（如果需要实时写入，循环内的Flush()可以保留，但using必须保留）：

using (var writer = new StreamWriter("output.txt"))
{
    foreach (var link in links)
    {
        var href = link.GetAttributeValue("href", "");
        writer.WriteLine(href);
        // writer.Flush(); // 可选，用于实时写入内容
    }
}

4. 排查HTML文件格式问题 #

如果测试HTML存在未闭合标签、异常嵌套等格式错误，可能导致HtmlAgilityPack解析时陷入死循环。先使用简化的测试HTML验证：

<html>
<body>
<a href="https://example.com">示例链接1</a>
<a href="https://test.org">示例链接2</a>
</body>
</html>

5. 捕获遍历中的潜在异常 #

在循环内添加异常捕获，避免单个节点解析失败导致整个进程卡住：

foreach (var link in links)
{
    try
    {
        var href = link.GetAttributeValue("href", "");
        writer.WriteLine(href);
    }
    catch (Exception ex)
    {
        writer.WriteLine($"节点解析失败：{ex.Message}");
    }
}

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