直接用 pip install jsonpath 安装原生库（非 jsonpath-ng），路径需以 $ 开头、无空格，传入已解析的 dict/list；匹配失败返回 False 而非空列表，须类型检查 isinstance(result, list) 后再处理。
jsonpath库安装与基础语法怎么写才不报错
直接用 pip install jsonpath 就行，注意不是 jsonpath-ng 或 jsonpath-rw —— 那些是不同实现，API 不兼容。原生 jsonpath 库（作者是 Krisztián Szűcs）只支持 Python 2.7 和 3.4+，但不支持数组切片语法如 [0:2]，也不支持函数调用如 length()。
最常踩的坑是路径开头加了 $ 却没传入完整 JSON 对象：比如你解析完的变量叫 data，那表达式就得写成 $.users[0].name，而不是 data.users[0].name；jsonpath 是字符串匹配引擎，不认 Python 变量名。
- 必须先用
json.loads()把字符串转成 dict/list，再传给jsonpath.jsonpath() - 表达式里不能有空格（
$.user name会静默失败，应写成$.userName或用引号：$['user name']） - 匹配不到时返回
False，不是空列表，别直接for item in result:，先判空
提取多层嵌套字段时如何避免 KeyError 或 IndexError
JSON 结构经常不规整：比如 data.items 有时是 list，有时是 null，有时干脆不存在。用 jsonpath 的好处是它天然跳过缺失路径，不会抛异常——但前提是写对通配符和条件过滤。
例如想取所有 address.city，但有些用户没 address 字段，有些有 address 却没 city。这时该用：$..address.city（.. 表示递归下降），而不是 $.users[*].address.city（后者在 address 缺失时整个分支失效）。
立即学习“Python免费学习笔记（深入）”；
-
*[?(@.status == 'active')]这种过滤语法只在jsonpath-ng支持，原生jsonpath不认?()，得靠 Python 后过滤 - 要安全取值，建议组合使用：
jsonpath(data, "$..items[*].price") or []，显式兜底 - 嵌套太深（>5 层）时，
jsonpath性能明显下降，不如用dict.get('a', {}).get('b', {}).get('c')手动链式取值
为什么用 jsonpath.jsonpath() 返回 False 而不是空列表
这是该库最反直觉的设计：当路径完全不匹配时，返回布尔值 False，而不是 []。很多人写 if result: 想判断是否找到，结果 False 被当成“没结果”，但其实 [] 也是 falsy，逻辑上没错；问题出在类型混淆——你后续想 result[0] 就直接 TypeError。
正确做法永远加类型检查：result = jsonpath.jsonpath(data, "$.config.timeout")，然后 if isinstance(result, list) and result: 再处理。别依赖隐式布尔转换。
- 返回
False的典型场景：根节点不存在（$下无匹配）、路径含非法字符、JSON 是字符串未解析 - 如果确定路径合法但总得
False，先 printtype(data)确认是 dict/list，不是 str - 调试时可用
jsonpath.jsonpath(data, "$")看是否返回[data]，验证输入是否正常
替代方案：什么时候该放弃 jsonpath 改用原生 Python
当你需要做以下操作时，硬套 jsonpath 反而更麻烦：
- 提取后还要做类型转换（比如把
"123"转成 int） - 需要根据某个字段值动态拼接另一层路径（
$.data.$key.value这种变量插值不支持） - 结构高度动态，字段名本身就是数据（如
{"2023-01": {"count": 5}}，想按日期遍历）
这时候直接写个递归函数或用 glom 库更稳。比如简单提取所有 id 字段：[item['id'] for item in data.get('results', []) if 'id' in item]，比写 $..id 更可控、可 debug。
jsonpath 的价值在「快速验证路径是否存在」和「一次性捞出分散在多层的同类字段」，不是万能 JSON 查询引擎。路径越复杂，维护成本越高，容易变成没人敢改的魔法字符串。
