推荐使用 HttpClient 实现 C# 中的文件下载，支持异步与流式处理，适合大文件；2. 可通过自定义流包装器报告进度，并添加请求头和超时设置以提升兼容性与稳定性；3. 注意结合 try-catch 处理网络异常，确保下载可靠性。
在 C# 中从 URL 下载文件是一个常见需求，比如下载图片、文档或软件安装包。实现方式有多种，可根据具体场景选择合适的方法。以下是几种常用且可靠的实现方式。
使用 WebClient（简单快捷）
WebClient 是最简单的下载方式，适合快速实现文件下载功能。说明： WebClient 封装了底层 HTTP 请求逻辑，使用 DownloadFile 方法可以直接将远程文件保存到本地。
示例代码：
using System.Net;
using (var client = new WebClient())
{
client.DownloadFile("https://example.com/file.pdf", @"C:\Downloads\file.pdf");
}
优点是代码简洁，缺点是 WebClient 在 .NET Core/.NET 5+ 中已被标记为过时，推荐使用 HttpClient。
使用 HttpClient（推荐方式）
HttpClient 更现代、灵活，并支持异步操作，适合在新项目中使用。说明： 通过 GetByteArrayAsync 或 GetStreamAsync 获取数据流，再写入本地文件。
示例代码（异步下载）：
using System.Net.Http;
using System.IO;
using var httpClient = new HttpClient();
var data = await httpClient.GetByteArrayAsync("https://example.com/image.jpg");
await File.WriteAllBytesAsync(@"C:\Downloads\image.jpg", data);
如需处理大文件，避免内存溢出，可使用流式下载：
using var response = await httpClient.GetAsync("https://example.com/largefile.zip", HttpCompletionOption.ResponseHeadersRead);
using var stream = await response.Content.ReadAsStreamAsync();
using var fileStream = new FileStream(@"C:\Downloads\largefile.zip", FileMode.Create, FileAccess.Write);
await stream.CopyToAsync(fileStream);
这种方式能有效控制内存使用，适合下载大文件。
添加进度和错误处理
实际应用中需要关注下载进度和网络异常。建议： 虽然 HttpClient 本身不直接提供下载进度，但可通过自定义流包装器来实现进度报告。同时应包裹 try-catch 处理网络中断、404 错误等情况。
基本异常处理示例：
try
{
using var response = await httpClient.GetAsync(url);
if (response.IsSuccessStatusCode)
{
using var stream = await response.Content.ReadAsStreamAsync();
using var fileStream = new FileStream(filePath, FileMode.Create);
await stream.CopyToAsync(fileStream);
}
else
{
Console.WriteLine($"下载失败：{response.StatusCode}");
}
}
catch (HttpRequestException ex)
{
Console.WriteLine($"网络错误：{ex.Message}");
}
设置请求头和超时时间
某些 URL 需要特定请求头（如 User-Agent）才能访问。说明： 可通过 HttpClient 的 DefaultRequestHeaders 添加必要信息，避免被服务器拒绝。
示例：
httpClient.DefaultRequestHeaders.Add("User-Agent", "Mozilla/5.0");
httpClient.Timeout = TimeSpan.FromMinutes(10); // 设置超时
基本上就这些。根据项目环境选择 WebClient 或 HttpClient，优先使用后者。注意处理异常、大文件流式写入和请求头配置，就能稳定实现 URL 文件下载功能。
