全书导言：XServer 是什么，这本书怎么读

本章导读

先给一句话定义：

XServer 是一个单文件 C 语言应用服务器：一个可执行文件（内嵌编译器与运行时），加一份纯 C 源码目录，就是一个完整的、可热重载的服务端部署。

这句话里有三个关键词，分别对应本书的三条主线：单文件（运行时与工具链全部内嵌，卷二讲构建与交付）、C 源码目录（应用不是预编译产物而是源码本身，卷一、卷三讲怎么写）、热重载（改代码零停机生效，卷四深潜）。

1.1 XServer 是什么

传统的 C 服务端开发是"写代码 → 编译 → 链接 → 部署二进制 → 重启"，任何一个业务改动都要走完这条流水线。XServer 把这条流水线折叠进了运行时：你在目标机上放的部署物就是源码目录，xs.exe 在启动与热重载时用内嵌的 TCC 编译器把你的 C 代码编译成原生机器码，在进程内直接运行。

/* 传统 C 服务 */
myapp/  →  build 流水线  →  myapp.exe + 依赖清单  →  目标机安装依赖  →  重启生效

/* xs */
myapp/  =  xs.exe（唯一二进制，内嵌编译器/运行时/SDK）
        + main.c + modules/ + wwwroot/ + db/（源码即部署物）
        →  拷贝即部署，改源码即热重载

这不是"用 C 写脚本"的玩具化，而是一次严格的工程取舍：脚本是可信的原生代码，与宿主同进程、按地址直调宿主的 3,030 个 xrt API——没有解释器开销，没有 FFI 边界，函数调用就是函数调用。代价是没有沙箱：XServer 面向运维可控的可信部署，不接受不可信的第三方脚本（这条边界在卷五第 44 章展开）。

底下托着 XServer 的是 xrt——31 万行自研运行时（TLS 1.2/1.3、HTTP/1.1、WebSocket、五后端事件循环、协程、内存调试）。本书不重复教 xrt：涉及 xrt 的基础能力时，会在章尾"延伸阅读"框里链到 xrt 官网教程的对应章节。

1.2 与其他方案的对照

一句话概括差异：其他方案把"运行环境"和"你的代码"当作两个东西管理，XServer 把它们装进同一个文件、同一个进程、同一套生命周期。

1.3 全书路线图

• 卷一（ch01-06）：心智模型与工具链。最重要的三章是 03（心智模型）、04（最小应用）、06（排错）。
• 卷二（ch07-13）：xs.json 是唯一的装配界面，逐字段讲透约束与错误语义。
• 卷三（ch14-25）：四类协议的开发模式，按你用的协议挑读。
• 卷四（ch26-31）：热重载从"会触发"到"懂语义"——回滚、交接、零泄漏。
• 卷五（ch32-44）：扩展机制、部署运维、安全边界，以及三个端到端实战项目。

1.4 章节模板契约

本书 51 章执行同一个八段式结构。第 1 章把这个模板写成契约——后续任何一章若不符合它，视为章节缺陷而不是风格差异：

章尾固定两个框：本章涉及的 API 参考（链到本书参考页并标注条目数）与 xrt 延伸阅读（链到 xrt 官网教程）。所有带"实机验证"标签的代码块，输出均为真实运行结果——包括动态端口、真实时间戳这类不可伪造的细节。

1.5 读者分流

常见错误

curl http://127.0.0.1:9080/__xs/status
/* 期望内置管理端点 → 404 */

/* 自己在脚本里写管理路由：
 * 巡检/重载入口是普通业务路由 */

编程练习