nlohmann/json解析json字符串最直接:头文件即用、支持自动类型推导和嵌套结构,但需用try/catch捕获parse_error异常,并通过e.byte定位错误字节位置。

用 nlohmann/json 解析 JSON 字符串最直接
如果你只是想把一段 JSON 文本转成 C++ 可操作的数据结构,nlohmann/json 是目前最省心的选择。它头文件即用,不依赖编译时链接,支持嵌套对象、数组、类型自动推导,而且错误提示相对友好。
常见错误现象:json::parse 抛出 json::parse_error 异常(比如 [json.exception.parse_error.101] parse error at line 1, column 2: syntax error while parsing value),通常是因为字符串含不可见控制字符、编码不是 UTF-8、或末尾多逗号。
- 确保输入是
std::string或std::string_view,且内容为合法 UTF-8 - 用
try/catch包住json::parse(),别让异常逃逸到顶层 - 若 JSON 来自网络或文件,先检查空值和 BOM 头(Windows 记事本保存的 UTF-8 常带 BOM)
try {
nlohmann::json j = nlohmann::json::parse(json_str);
int code = j.at("code").get<int>(); // .at() 抛异常,.value() 返回默认值
} catch (const nlohmann::json::parse_error& e) {
std::cerr <h3>解析失败时怎么定位具体哪一行哪一列</h3>
<p><code>nlohmann/json</code> 的异常对象里有 <code>e.byte</code> 字段,表示出错位置在原始字符串中的字节偏移。但你要换算成“行/列”,得自己按换行符统计——它不内置行号信息。</p>
<ul>
<li>用 <code>std::count(json_str.begin(), json_str.begin() + e.byte, '\n')</code> 算行号(从 0 开始)</li>
<li>用 <code>e.byte - 上一行末尾位置</code> 算列号(注意:UTF-8 多字节字符会占多个字节,列号 ≠ 字节数)</li>
<li>如果需要精确行列定位,建议预处理 JSON 字符串:加行号前缀或用调试器断点查看 <code>json_str.substr(e.byte - 20, 40)</code>
</li>
</ul>
<p>注意:<code>e.byte</code> 指的是解析器读到非法内容时已消耗的字节数,不是非法字符起始位置。例如 <code>{"a": }</code> 中的 <code>}</code> 前缺值,<code>e.byte</code> 指向 <code>}</code> 本身。</p><div class="aritcle_card flexRow artxards">
<div class="artcardd flexRow">
<a class="aritcle_card_img" rel="nofollow" href="/xiazai/gongju/2823" title="C++14 标准参考"><img
src="https://img.php.cn/upload/manual/001/431/639/6ac8a6b18157d312.png" alt="C++14 标准参考" onerror="this.onerror='';this.src='/static/lhimages/moren/morentu.png'" ></a>
<div class="aritcle_card_info flexColumn">
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14 标准参考" class="overflowclass">C++14 标准参考</a>
<p class="overflowclass">C++14 标准最终草案参考资料,适合旧项目兼容、语言特性对照、标准库行为核对和现代 C++ 迁移学习。</p>
</div>
<a rel="nofollow" href="/xiazai/gongju/2823" title="C++14 标准参考" class="aritcle_card_btn flexRow flexcenter"><b></b><span>下载</span>
</a>
</div>
</div>
<h3>不用第三方库时,<code>std::regex</code> 能不能凑合解析简单 JSON</h3>
<p>不能。正则表达式无法正确处理嵌套结构(比如 <code>{"x": {"y": [1, {"z": true}]}}</code>),也无法区分字符串内的引号和结构分隔符。有人试过匹配 <code>"key":\s*"(.*?)"</code>,但只要值里含转义双引号(<code>"name": "O\"Reilly"</code>)就立刻失效。</p>
<ul>
<li>
<code>std::regex</code> 适合提取固定模式字段(如 HTTP 响应头里的 <code>Content-Type: application/json</code>),不适合解析 JSON 主体</li>
<li>手写递归下降解析器理论上可行,但需完整实现 JSON 5 种类型、转义规则、空白跳过、数字精度处理——实际项目中没人这么干</li>
<li>系统级限制场景(如裸机、无 STL)才考虑轻量解析器(如 <code>jsmn</code>),但它返回 token 数组,仍需你自己映射逻辑</li>
</ul>
<h3>解析后访问字段时常见的类型安全陷阱</h3>
<p><code>nlohmann/json</code> 是运行时类型,<code>j["field"]</code> 返回 <code>json</code> 类型,不强制转换就取值会触发 <code>json::type_error</code>。</p>
<ul>
<li>用 <code>j.at("field").get<int>()</int></code> —— 若 key 不存在或类型不符,抛异常</li>
<li>用 <code>j.value("field", 0)</code> —— 若 key 不存在或类型不符,返回默认值(但不会校验类型是否真能转成 <code>int</code>)</li>
<li>用 <code>j["field"].is_number_integer()</code> 先判断再取,适合容错逻辑</li>
<li>数组访问别越界:<code>j["items"][i]</code> 不检查索引,<code>j["items"].at(i)</code> 才抛 <code>out_of_range</code>
</li>
</ul>
<p>特别注意浮点数:JSON 规范没区分 float/double,<code>nlohmann</code> 默认用 <code>double</code> 存,<code>.get<float>()</float></code> 可能丢失精度;整数超 <code>int64_t</code> 范围时会静默转成 double,再 <code>.get<int64_t>()</int64_t></code> 就失败。</p>
<p>解析 JSON 表面是字符串转对象,实际难点在错误恢复、类型边界、编码一致性这些看不见的地方。尤其当 JSON 来自外部不可信源时,<code>at()</code> 和 <code>is_xxx()</code> 配合用比盲目 <code>get()</code> 更稳妥。</p></int>C++免费学习笔记(深入):立即使用
在学习笔记中,你将探索 C++ 的入门与实战技巧!










