C#开发Windows服务完整教程：从创建项目到注册后台自启，一步步教你实现
Windows服务是Windows操作系统提供的一种特殊应用程序类型，它可以在系统启动时自动运行，不需要用户登录交互界面。这种特性使得Windows服务特别适合执行后台任务，比如定时备份数据库、监控文件变化、处理队列消息等。使用C#开发Windows服务非常方便，因为.NET框架提供了完整的类库支持，开发完成后只需要简单配置就能注册为系统服务。
一、开发前的准备工作
安装Visual Studio并配置工作负载
要开发Windows服务，首先需要安装Visual Studio开发环境。推荐使用Visual Studio 2019或2022版本，社区版免费且功能完整。在安装过程中，务必勾选“.NET桌面开发”工作负载，因为Windows服务项目依赖于.NET Framework的相关组件。如果你已经安装了Visual Studio但没有勾选这个工作负载，可以通过修改安装程序来添加。
选择合适的.NET Framework版本
虽然.NET Core和.NET 5/6/7也支持创建Windows服务，但传统方式仍然使用.NET Framework，因为它的服务基类（ServiceBase）最为成熟稳定。本文以.NET Framework 4.7.2为例进行讲解，其他版本的流程大同小异。如果你的电脑上没有这个版本，可以选择4.6.1或4.8，不影响操作。
二、创建Windows服务项目
找到正确的项目模板
打开Visual Studio，点击“创建新项目”。在项目模板搜索框中输入“Windows服务”，你会看到一个名为“Windows 服务 (.NET Framework)”的模板。注意不要选错成“Worker Service”（那是.NET Core的）。选中后点击“下一步”。
配置项目基本信息
在弹出的对话框中，填写项目名称和保存位置。项目名称最好用英文，比如“MyWindowsService”，因为服务注册时要用到这个名称。解决方案名称可以和项目名称相同。点击“创建”后，Visual Studio会自动生成一个基础的项目结构，主要包括两个文件：一个是继承自ServiceBase的服务类（默认叫Service1.cs），另一个是程序的入口点Program.cs。
三、编写服务核心逻辑
理解服务类的生命周期
默认生成的Service1.cs中包含了两个重要的方法：OnStart和OnStop。OnStart在服务启动时被调用，你应该在这里初始化资源、启动定时器或开启线程。OnStop在服务停止时被调用，你需要在这里释放资源、关闭连接。除了这两个方法，还可以重写OnPause、OnContinue、OnShutdown等，但最常用的是前两个。
编写一个具体的服务示例
假设我们要实现一个服务，每隔5秒钟向一个日志文件写入一条记录，记录当前时间和服务状态。下面是完整的代码：
using System;
using System.IO;
using System.ServiceProcess;
using System.Threading;
namespace MyWindowsService
{
public partial class MyService : ServiceBase
{
private Timer workTimer; // 定时器，用于周期性执行任务
private readonly string logPath = @"C:\ServiceLog\service_log.txt";
private bool isRunning = false; // 标记服务是否在运行
public MyService()
{
InitializeComponent();
this.ServiceName = "MyDemoService"; // 设置服务名称，后续注册要用
}
protected override void OnStart(string[] args)
{
isRunning = true;
// 确保日志目录存在
string dir = Path.GetDirectoryName(logPath);
if (!Directory.Exists(dir))
{
Directory.CreateDirectory(dir);
}
// 写入启动日志
File.AppendAllText(logPath, $"{DateTime.Now:yyyy-MM-dd HH:mm:ss} 服务启动\n");
// 创建定时器，第一个参数是要执行的方法，第二个参数是状态对象（不用就传null）
// 第三个参数是首次执行的延迟时间（毫秒），第四个参数是间隔时间（毫秒）
workTimer = new Timer(DoWork, null, 0, 5000);
}
private void DoWork(object state)
{
if (!isRunning) return;
string content = $"{DateTime.Now:yyyy-MM-dd HH:mm:ss} 服务正在运行，执行定时任务\n";
File.AppendAllText(logPath, content);
}
protected override void OnStop()
{
isRunning = false;
workTimer?.Dispose(); // 释放定时器资源
File.AppendAllText(logPath, $"{DateTime.Now:yyyy-MM-dd HH:mm:ss} 服务停止\n");
}
}
}重要说明：如果你在创建项目时没有自动生成InitializeComponent方法，可以手动添加一个私有方法，并在构造函数中调用。这个方法用来设置服务的基本行为，比如是否允许停止、暂停、关机等。示例如下：
private void InitializeComponent()
{
this.CanShutdown = true; // 允许系统关机时通知服务
this.CanStop = true; // 允许停止服务
this.CanPauseAndContinue = false; // 不允许暂停和继续
}关于定时器的选择
上面使用了System.Threading.Timer，它是轻量级的多线程定时器，适合后台任务。另一种选择是System.Timers.Timer，用法类似。需要注意的是，不要在定时器的回调函数中执行耗时很长的操作，否则可能导致定时器重叠。如果任务可能耗时较长，可以考虑使用单独的线程或异步方式。
四、添加服务安装组件
为什么要安装组件
Windows服务不像普通程序那样双击就能运行，它必须通过系统服务管理器注册后才能启动。注册时需要知道服务的名称、显示名称、运行账户等信息。这些信息可以通过添加服务安装组件来指定，这样在后续使用InstallUtil工具注册时就会自动读取。
添加安装程序的具体步骤
在Visual Studio中，双击服务类文件（比如MyService.cs），进入设计视图。在设计界面的空白处右键单击，选择“添加安装程序”。系统会自动生成一个名为ProjectInstaller.cs的文件，里面包含两个核心组件：serviceInstaller1和serviceProcessInstaller1。
配置组件属性
选中serviceProcessInstaller1，在属性窗口中将其Account属性设置为LocalSystem。LocalSystem是本地系统账户，拥有很高的权限，可以访问大多数系统资源。如果服务需要访问网络资源，可以考虑使用NetworkService或自定义账户。
选中serviceInstaller1，配置以下属性：
ServiceName：必须与服务类中设置的this.ServiceName一致，这里填MyDemoService。DisplayName：在服务管理器中显示的友好名称，比如“我的演示服务”。Description：对服务的简要描述，方便管理员识别用途，比如“这是一个定时写入日志的演示服务”。StartType：设置为Automatic，这样服务注册后会自动启动，达到后台自启的效果。也可以设为Manual（手动启动）或Disabled（禁用）。
五、编译生成服务程序
生成可执行文件
右键点击项目，选择“生成”（或按Ctrl+Shift+B）。如果编译没有错误，会在项目的bin\Debug或bin\Release目录下生成一个.exe文件，这就是最终的服务程序。注意：一定要记住这个exe文件的完整路径，后续注册服务时需要用到。建议切换到Release模式再生成一次，以获得更小的体积和更好的性能。
验证生成结果
打开输出目录，你应该能看到类似MyWindowsService.exe的文件。可以尝试直接双击运行，但会弹出一个错误提示，因为Windows服务不能像普通程序那样直接启动，这是正常现象。
六、注册Windows服务并设置自启
方法一：使用sc命令（推荐）
sc是Windows系统自带的命令行工具，功能强大且无需额外安装。以管理员身份打开命令提示符（右键点击开始菜单，选择“命令提示符(管理员)”或“Windows PowerShell(管理员)”），执行以下命令：
sc create MyDemoService binPath= "C:\MyWindowsService\bin\Release\MyWindowsService.exe" start= auto命令解释：
MyDemoService：服务的名称，必须与代码中设置的ServiceName一致。binPath=：后面跟服务exe的完整路径，注意等号后面必须有一个空格，路径用英文双引号括起来。start= auto：设置启动类型为自动。如果希望手动启动，可以改为start= demand。
如果命令执行成功，会显示“[SC] CreateService 成功”。此时打开服务管理器（按Win+R，输入services.msc回车），就能看到刚刚注册的服务，启动类型为“自动”。
方法二：使用InstallUtil工具
InstallUtil是.NET Framework自带的安装工具，位于C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe（64位系统）或C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe（32位系统）。同样以管理员身份打开命令提示符，执行：
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe "C:\MyWindowsService\bin\Release\MyWindowsService.exe"执行成功后，服务会被注册，并且由于之前在安装组件中设置了StartType为Automatic，所以服务已经是自动启动状态。
两种方式的比较：sc命令更简洁，不依赖.NET运行时，适合快速部署。InstallUtil则能利用安装组件中的详细配置，比如可以设置服务描述、依赖关系等。建议初学者先用sc命令，熟悉后再尝试InstallUtil。
七、服务的启动、停止和卸载
启动服务
注册完成后，服务并不会立即运行，需要手动启动。有以下几种方式：
- 图形界面：打开
services.msc，找到你的服务，右键点击“启动”。 - 命令行：
sc start MyDemoService
停止服务
- 图形界面：右键点击服务，选择“停止”。
- 命令行：
sc stop MyDemoService
卸载服务
如果需要删除服务，必须先停止服务，然后执行：
- 使用sc：
sc delete MyDemoService - 使用InstallUtil：
C:\...\InstallUtil.exe /u "C:\...\MyWindowsService.exe"
注意：卸载后，服务在服务管理器中消失，但exe文件不会被删除，你可以手动清理。
八、常见问题及解决方法
服务注册失败
最常见的原因是命令提示符没有以管理员身份运行。Windows服务属于系统级组件，普通用户无权注册。另外，检查exe路径是否正确，路径中不要有中文或空格（如果有，必须用双引号括起来）。还要确认服务名称没有被占用，可以用sc query查看已有服务。
服务启动后马上停止
这种情况通常发生在OnStart方法中抛出了未捕获的异常。由于Windows服务没有控制台窗口，异常信息不会显示出来，导致服务瞬间崩溃。解决方法是在OnStart中添加try-catch，并将错误信息写入日志文件，比如：
protected override void OnStart(string[] args)
{
try
{
// 你的初始化代码
}
catch (Exception ex)
{
// 将异常写入事件日志或文件
EventLog.WriteEntry("MyDemoService", ex.ToString(), EventLogEntryType.Error);
throw; // 抛出异常会让服务停止，但至少记录了错误
}
}服务无法写入日志文件
如果日志文件路径设置在C盘根目录或Program Files等受保护目录，LocalSystem账户也可能没有写入权限。解决办法是将日志路径改到一个所有用户都有写入权限的目录，比如C:\Temp或C:\ProgramData\YourApp。也可以在目标文件夹上手动赋予“Everyone”写入权限。
服务在调试时无法直接运行
前面提到过，Windows服务不能像普通程序那样按F5运行。如果你想调试服务，可以采用附加进程的方式：先启动服务，然后在Visual Studio中选择“调试”->“附加到进程”，找到你的服务进程（通常是exe名称），附加后就可以设置断点了。或者，你也可以临时将服务逻辑放在一个控制台应用程序中调试，确认无误后再移植到服务项目中。
九、进阶技巧与最佳实践
使用事件日志记录信息
除了写文件日志，还可以使用Windows事件日志。在OnStart中添加如下代码：
if (!EventLog.SourceExists("MyDemoService"))
EventLog.CreateEventSource("MyDemoService", "Application");
EventLog.WriteEntry("MyDemoService", "服务启动", EventLogEntryType.Information);这样错误信息会出现在“事件查看器”中，便于集中管理。
支持暂停和继续
如果服务需要临时暂停但不停止，可以在服务类中设置CanPauseAndContinue = true，然后重写OnPause和OnContinue方法，在里面挂起和恢复定时器。
处理系统关机
当Windows关机时，服务会收到OnShutdown事件。如果你有需要保存的状态，可以在OnShutdown中进行处理。记得在InitializeComponent中将CanShutdown设为true。
总结
通过以上步骤，你已经掌握了使用C#开发Windows服务的完整流程。从创建项目、编写业务逻辑、添加安装组件，到注册服务并设置自动启动，每一步都有详细的说明。Windows服务是一个非常实用的技术，可以帮你实现各种后台自动化任务。只要按照本文的指引，多加练习，很快就能熟练运用。如果在实践中遇到任何问题，欢迎在评论区留言交流。