C# 怎么创建一个 Windows 服务_C# Windows 服务创建与部署指南

来源:这里教程网 时间:2026-02-21 17:29:59 作者:

创建一个 Windows 服务在 C# 中并不复杂,但需要理解其运行机制和部署流程。Windows 服务是在后台运行的长期进程,适合执行定时任务、监控系统或托管长时间运行的服务逻辑。下面是一个完整的创建与部署指南。

创建 Windows 服务项目

打开 Visual Studio,按照以下步骤新建项目:

选择“创建新项目” 搜索并选择“Windows 服务 (.NET Framework)”模板(注意:目前原生 .NET/.NET Core/.NET 5+ 的 Windows 服务需手动配置,推荐使用 .NET 6 或以上版本配合 Worker Service 模板) 命名项目,例如 MyWinService

如果你使用的是 .NET 6 或更高版本,建议选择“Worker Service”模板,它更适合现代 Windows 服务开发,并支持跨平台。

编写服务逻辑(以 .NET 6 Worker Service 为例)

Program.cs 中,使用内置的宿主模型来注册后台服务:

builder.Services.AddHostedService();

Worker.cs 文件中实现你的业务逻辑:

public class Worker : BackgroundService
{
private readonly ILogger _logger;

public Worker(ILogger<Worker> logger)  
{  
    _logger = logger;  
}  
protected override async Task ExecuteAsync(CancellationToken stoppingToken)  
{  
    while (!stoppingToken.IsCancellationRequested)  
    {  
        _logger.LogInformation("Worker running at: {time}", DateTimeOffset.Now);  
        await Task.Delay(1000, stoppingToken); // 每秒执行一次  
    }  
}  

}

这个 Worker 类继承自 BackgroundService,会在服务启动时自动调用 ExecuteAsync 方法。

将应用配置为 Windows 服务

要让 .NET 应用作为 Windows 服务运行,需要添加 NuGet 包并修改宿主配置。

安装 NuGet 包:Microsoft.Extensions.Hosting.WindowsServices

修改 Program.cs,启用 Windows 服务支持:

var isService = !string.IsNullOrEmpty(Environment.GetCommandLineArgs().FirstOrDefault(arg => arg.ToLower() == "--windows-service"));

var builder = Host.CreateApplicationBuilder(args);

if (isService)
{
builder.Services.AddWindowsService(options =>
{
options.ServiceName = "MySampleWinService";
});
}
else
{
builder.Services.AddConsoleLifetime();
}

builder.Services.AddHostedService();

var host = builder.Build();

await host.RunAsync();

这样,当应用以服务方式运行时,会自动识别并注册为 Windows 服务。

发布与部署服务

完成开发后,发布项目并部署为服务:

右键项目 → “发布” → 选择文件夹发布路径(如 C:\MyServices\MyWinService 使用 sc 命令行工具安装服务:

sc create MySampleWinService binPath="C:\MyServices\MyWinService\MyWinService.exe --windows-service" start=auto

说明:

MySampleWinService 是服务名称 binPath 指向可执行文件,并传递 --windows-service 参数用于识别运行模式 start=auto 表示开机自启

启动服务:

sc start MySampleWinService

查看服务状态:

sc query MySampleWinService

卸载服务(如需):

sc delete MySampleWinService

调试与日志建议

Windows 服务无法直接调试。建议:

开发阶段通过控制台运行(不传 --windows-service 参数),验证逻辑 使用 ILogger 记录日志,输出到文件或 Event Log 部署后检查 Windows 事件查看器中的应用程序日志

若需写入 Windows 事件日志,可添加:

builder.Logging.AddEventLog();

基本上就这些。只要结构清晰,.NET 的宿主模型让 Windows 服务变得简单可控。

相关推荐