cpptoml是解析TOML最省心的选择：轻量、头文件即用、C++11兼容，支持TOML v0.5.0；但不支持表数组和inline table，读取失败抛cpptoml::parse_exception，需try/catch捕获。
用 cpptoml 解析 TOML 是最省心的选择
如果你只是想快速读取配置、不碰底层语法、也不打算自己写 parser，cpptoml 是目前 C++ 生态里最成熟、零依赖、头文件即用的方案。它支持 TOML v0.5.0（覆盖绝大多数日常配置场景），且编译期无额外开销。
实操建议：
组合式C++代码评审方案，融合静态分析、AI推理、多轮迭代评审和C++专项检查，适用于PR审查、增量代码审查、全项目评审和代码质量评分，触发词包括review cpp、cpp代码评审、C++review、代码审查。
立即学习“C++免费学习笔记（深入）”；
- 从 GitHub 仓库 下载单头文件
cpptoml.h，直接#include进项目 - 确保编译器支持 C++11（至少要有
auto、std::shared_ptr、lambda） - 读取失败时，
cpptoml::parse_file()会抛出cpptoml::parse_exception，必须捕获——否则静默崩溃 - 不要尝试用
std::ifstream自己读字符串再喂给cpptoml::parse()：编码换行符处理可能出错，优先走parse_file()
toml11 更现代但需 C++17，适合需要表数组或 inline table 的项目
当你的 TOML 里用了 [[servers]] 这类表数组，或嵌套 foo = {a=1, b=2} 这种 inline table，cpptoml 会解析失败或丢数据。toml11 支持完整 TOML v1.0.0，且 API 更符合现代 C++ 习惯。
实操建议：
立即学习“C++免费学习笔记（深入）”；
- 用 CMake 引入：
find_package(toml11 REQUIRED)，或直接下载toml.hpp（单头，但依赖<optional>、<variant>） - 解析后拿到的是
toml::value，类型安全访问必须用toml::get<T>(v)，比如toml::get<int>(v.at("port")) - 访问不存在的 key 会抛
toml::type_error或std::out_of_range，别忘了 try/catch - 若项目已用 C++17，
toml11的toml::parse_file()返回std::optional<toml::value>，比异常更轻量
手动解析？除非你只读几个固定字段，否则别碰
有人想用 std::regex 或 std::getline + 字符串切分来“手撕” TOML——这在 key = "hello \"world\"" 或多行字符串、注释混排时立刻崩盘。TOML 表名、键名允许点号、引号、空格，甚至 Unicode，正则根本不可靠。
仅当满足全部条件时可考虑简化路径：
- 配置文件完全由你控制，且永远只含 flat 结构（无嵌套、无数组）
- 所有 key 都是 ASCII 字母+下划线，值都是整数或纯字母字符串
- 你愿意为每个字段写重复的
if (line.find("port = ") == 0)类逻辑 - 能接受后续加个注释或换行就导致解析失败
常见错误：中文路径、BOM、时区时间戳解析失败
Windows 上用记事本保存的 TOML 常带 UTF-8 BOM，cpptoml 会报 “unexpected character at beginning”，toml11 默认也拒绝 BOM。还有人把 started = 2023-04-01T12:34:56+08:00 当字符串读出来，却没意识到 toml11 实际解析成 std::chrono::system_clock::time_point，直接 get<std::string> 会 throw。
避坑要点：
- 用 VS Code / Notepad++ 保存为 “UTF-8 without BOM”
- 读时间戳前先
toml::get<toml::date_time>(v.at("started"))，再转格式；别硬转 string - 路径含中文？确保编译器和运行环境 locale 一致，Windows 下推荐用
std::filesystem::u8path()处理 utf8 字符串路径 -
cpptoml不支持local time offset（如+08:00），遇到就报错；toml11支持，但需确认版本 ≥ 3.7.1
