llbc 用户指南

llbc（Low Level Base Component）是一套简洁、高效、跨平台、多语言支持的服务端开发框架，秉持「麻雀虽小，五脏俱全」的理念，以 App → Service → Component 的方式组织业务，让开发者以极低的学习、使用与接入成本完成服务端底层搭建与功能开发。底层由 C++17 实现，广泛用于游戏与通用服务端开发。

注：llbc 框架本身不包含具体业务组件；较为通用的组件由独立仓库 llbc_comps 提供，欢迎贡献。

llbc 提供了什么

在一个库中集成了服务端开发常用的一整套子系统，并尽量减少对第三方库的依赖：

高性能网络层 —— 可插拔 Poller 后端（Linux epoll / Windows IOCP / 通用 select），协议栈可定制。
一站式核心库 —— 线程、定时器、日志、对象池、序列化（LLBC_Stream）、配置（ini/xml/properties）、时间、随机、LLBC_Variant、委托（LLBC_Delegate）、事件、文件/目录、动态库加载、文本编码转换、调试工具、错误码等常用能力开箱即用。
多语言封装 —— 在 C++ 核心之上提供 Python / C# / Lua 封装，脚本层可直接复用底层能力。

适用场景

游戏服务端、长连接网关、房间/对局服、通用 TCP 服务，以及任何需要「组件化业务 + 高性能网络 + 完整基础库」的 C++ 服务端。

从这里开始

本文档按学习旅程线性组织，覆盖入门、核心概念、基础库与网络使用指南、参考与更多。

入门
- 安装与构建：用 CMake（Linux/macOS）或 Visual Studio（Windows）编译核心库。
- Hello World：最小可运行程序，理解 LLBC_Startup/LLBC_Cleanup。
- 第一个 Service：创建 Service、挂载 Component、启动运行。
- 第一个网络回显服务：监听、订阅 opcode、收发网络包。
核心概念
- 架构总览、Service 与 Component、生命周期与事件、App 与多服务组合、错误处理与返回约定、内存与对象所有权。
使用指南 · 基础库
- Stream、Variant、Delegate、Object、ObjPool、Array/Dictionary、日志、定时器、时间、线程与任务、事件、配置、字符串、文件与目录、随机、动态库、编码转换、工具箱 utils。
使用指南 · 网络
- Service 消息处理、Packet 与 Coder、Session 与连接、协议栈与自定义协议、Poller 后端。
参考 —— 错误码一览、日志配置项、Service / App 配置项。
更多 —— 常见问题、贡献指南、版本迁移指南 v1.1.1、术语表、更新日志。

支持平台

平台	支持级别	说明
Linux	一级	稳定，特性最新，可用于线上生产环境
Windows	一级	稳定，特性最新，可用于线上生产环境
macOS	二级	稳定，但网络部分性能较低，不建议线上生产
iOS	尽力	理论支持，已不再主动维护
Android	尽力	理论支持，已不再主动维护