VS 中创建并安装.NET Framework Windows 服务教程

Windows 服务(Windows Service)是可以在后台长期运行的应用程序,以下是基于 Visual Studio 创建并安装.NET Framework 版本 Windows 服务的完整步骤:
一、创建 Windows 服务项目

复制代码
打开 Visual Studio(建议使用 2019/2022 版本),新建项目,搜索并选择「Windows 服务(.NET Framework)」模板,确认.NET Framework 版本(推荐 4.6 及以上)后创建项目。
项目创建完成后,会自动生成一个服务类文件(默认名称如Service1.cs),右键该文件选择「查看代码」,进入代码编辑界面。
该类中默认包含两个核心事件方法:
    OnStart:服务启动时触发,可在此编写服务运行的核心业务逻辑(如定时任务、监听端口等);
    OnStop:服务停止时触发,可在此编写资源释放逻辑(如关闭数据库连接、停止线程等)。

二、编译并安装服务

复制代码
编写完业务逻辑后,右键项目选择「生成」(或按 F6),生成完成后找到编译输出路径:
    调试模式(Debug):项目目录 \bin\Debug;
    发布模式(Release):项目目录 \bin\Release(生产环境建议用此模式)。
以管理员身份打开 CMD 命令提示符(关键!普通权限会导致安装失败),导航到编译输出路径:
bash
运行

# 示例路径,替换为你的实际路径
cd /d D:\Test\Test.Host\bin\Debug

执行安装命令(需匹配.NET Framework 版本和系统位数):
bash
运行

# 64位系统 + .NET Framework 4.x
C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe TestService.exe

# 32位系统 + .NET Framework 4.x(若适用)
# C:\Windows\Microsoft.NET\Framework\v4.0.30319\InstallUtil.exe TestService.exe

安装成功后,打开 Windows 服务管理器验证:
    方式 1:按下Win + R,输入services.msc回车;
    方式 2:控制面板 → 管理工具 → 服务。
    在服务列表中即可找到你安装的服务(默认名称为项目中设置的服务名),可手动启动 / 停止服务。

三、补充实用说明

复制代码
卸载服务:若想卸载服务,先执行卸载命令:
bash
运行

C:\Windows\Microsoft.NET\Framework64\v4.0.30319\InstallUtil.exe /u TestService.exe

更新服务:先停止你的服务运行,然后在vs中去重新编译,最后在服务中重启启动即可,不需要卸载服务后重新安装;

服务命名:建议在创建服务时修改默认服务名(在服务类的设计视图中,右键→属性,设置「ServiceName」),避免与系统服务重名。
调试技巧:直接安装服务调试不便,可在Main方法中临时添加控制台输出逻辑,先以控制台程序运行调试,确认逻辑无误后再安装为服务。

总结

复制代码
核心关键点:编写 Windows 服务的业务逻辑需放在OnStart/OnStop方法中,这是服务启动 / 停止的入口;
安装必备条件:必须以管理员身份运行 CMD,否则会因权限不足导致安装失败;
路径注意事项:InstallUtil.exe的路径需匹配系统位数(Framework/Framework64)和.NET Framework 版本,避免路径错误。

关键点回顾

复制代码
编辑服务逻辑的核心是重写OnStart(启动)和OnStop(停止)方法;
安装服务时 CMD 必须以管理员身份运行,且需使用对应版本的InstallUtil.exe;
记得通过services.msc验证服务安装结果,卸载服务需加/u参数。
相关推荐
雾沉川2 小时前
Nano11 25H2 精简版 Windows11 系统介绍与部署实操教程
windows
张世争4 小时前
armcc5 c++98 的静态库裁剪大小的方法
windows·静态库·裁剪·armcc
vsropy5 小时前
安装虚拟机VMware
linux·windows
AI行业学习5 小时前
CC‑Switch v3.16.1-下载、配置、安装(2026‑06‑01 最新官方版)
开发语言·人工智能·windows·python
Meaauf5 小时前
Windows11关闭VBS的方法合集
windows
記億揺晃着的那天5 小时前
Windows 通过 Java 获取可用端口的一个坑:Hyper-V 保留端口导致 UDP 绑定失败
java·windows·udp
8Qi85 小时前
Windows 系统Claude Code安装与使用笔记
windows·笔记·agent·claudecode
c_lb72885 小时前
期货量化策略从 Windows 迁到 Linux 服务器:环境注意点
linux·服务器·windows·python
骑士雄师6 小时前
18.1 星系案例:多智能体宇宙探索系统(学习langgraph 的存储知识)
windows·python·学习
韭菜钟6 小时前
Windows下编译coal
windows