Windows服务必须通过StartServiceCtrlDispatcher注册并由SCM托管，入口为ServiceMain；直接运行会假死，需用sc create注册后启动，并及时调用SetServiceStatus上报状态，否则报1053错误。
Windows 服务程序必须用 StartServiceCtrlDispatcher 启动，不能直接运行 main
控制台程序默认以普通进程启动，而 Windows 服务要求由 SCM（Service Control Manager）托管，入口函数必须是 ServiceMain，且需通过 StartServiceCtrlDispatcher 注册服务表。直接双击或命令行运行会卡在等待 SCM 调用，看起来像“假死”——这不是 bug，是设计使然。
实操要点：
- 主函数里不能写业务逻辑，只做服务注册：
StartServiceCtrlDispatcher接收一个SERVICE_TABLE_ENTRY数组，其中包含服务名和对应的ServiceMain函数指针 -
ServiceMain内部才调用RegisterServiceCtrlHandlerEx设置控制处理器（如处理 STOP、PAUSE），并进入实际工作循环 - 调试时别双击 exe：用
sc create MySvc binPath= "C:\path\to\svc.exe" start= demand注册后，再用sc start MySvc启动；或用srvany（不推荐）绕过原生服务结构——但会导致无法响应服务控制信号
服务程序必须显式调用 SetServiceStatus，否则 SCM 认为启动失败
SCM 不关心你的代码是否在跑，只看你有没有按时上报状态。从 ServiceMain 开始，必须立刻调用 SetServiceStatus 报告 SERVICE_START_PENDING，并在初始化完成后切到 SERVICE_RUNNING。漏掉这步，sc start 会超时返回 “1053 错误：服务没有及时响应启动或控制请求”。
常见错误场景：
windows-shell
下载
Windows 命令行编码与兼容规范。涵盖 GBK/UTF-8 编码、PowerShell/pwsh 互操作、Python/Node.js、Git 配置及代码生成规则。适用于 Windows 10/11 + MSYS2/Git Bash 环境下的所有命令行操作。
立即学习“C++免费学习笔记（深入）”；
- 初始化耗时操作（如加载大配置、连接数据库）放在
ServiceMain里同步执行，又没发SERVICE_START_PENDING—— SCM 等 30 秒就放弃 - 忘记在每次状态变更后调用
SetServiceStatus，比如暂停后没报SERVICE_PAUSE_PENDING→SERVICE_PAUSED，导致服务管理器界面显示异常 - 多线程服务中，在非主线程调用
SetServiceStatus（必须是注册的 service thread）→ 返回失败但容易被忽略
打包注册要用 sc create + 正确参数，路径空格和权限是高频坑点
sc create 是最轻量、最可控的注册方式，不需要第三方工具或安装程序。但 Windows 对路径和权限极其敏感：
- 路径含空格必须用英文双引号包裹整个
binPath=值，且引号内不能有多余空格：sc create MySvc binPath= "C:\My Tools\svc.exe"✅，sc create MySvc binPath="C:\My Tools\svc.exe"❌（末尾空格会让 SCM 解析失败） - 服务默认以
LocalSystem运行，但该账户无网络访问权限、不能交互式桌面登录；如需访问网络或用户目录，改用obj= "NT AUTHORITY\NetworkService"或指定域账户（需提前授予权限） - 注册后立即启动失败？先查事件查看器 → Windows 日志 → 应用程序，过滤来源为“Service Control Manager”，错误详情比命令行提示准确得多
C++ 服务程序要主动处理日志和异常，控制台输出完全不可见
服务进程没有标准输入输出句柄，printf/std::cout 全部静默丢弃。所有调试和运行时信息必须落地到文件或 Windows 事件日志。
- 用
ReportEvent写入系统事件日志（需先用RegisterEventSource注册源），比文件日志更符合 Windows 服务规范，且能被集中监控工具采集 - 避免在
ServiceMain或控制处理器中 throw C++ 异常：SEH 异常可能被 SCM 捕获为崩溃，C++ 异常若未在 service thread 中捕获，会导致服务进程直接退出，SCM 记录为“意外终止” - 服务停止时，务必在
ServiceMain返回前清理资源（关闭文件、释放内存、断开 socket），不要依赖全局对象析构——SCM 可能强制终止进程
sc create 命令，而在 ServiceMain 里那几行 SetServiceStatus 调用的位置和参数。 
