jsonpath在python中需安装jsonpath-ng库，路径书写须注意点号与方括号用法、数组索引不可省略、特殊键名用['key']、推荐使用..递归操作符但慎用于大数据，应直接使用response.json()而非手动loads，并妥善处理异常与空结果。
JsonPath在Python里不原生支持，得装第三方库
Python标准库没有jsonpath，必须用jsonpath-ng（推荐）或jsonpath-rw。前者维护活跃、支持Python 3.7+，后者已停更且有兼容问题。别试jsonpath（小写包名），那是另一个不兼容的旧实现，容易返回空结果还报错不明确。
安装命令：
pip install jsonpath-ng
- 如果项目用了
pipenv或poetry，记得同步进依赖列表，否则CI环境会失败 - Windows下若提示编译错误，先升级
setuptools和wheel再重试 - 避免同时装多个JsonPath库，它们的语法解析器冲突，
import时可能静默覆盖
提取深度嵌套字段时，路径写错一个点就全空
JsonPath路径对.和['key']敏感，尤其嵌套数组+对象混合结构。比如API返回：
{"data": {"items": [{"id": 1, "meta": {"status": "ok"}}]}}，想取status，正确写法是：$.data.items[0].meta.status，不是$.data.items[0].meta["status"]（引号在jsonpath-ng里不合法）。
-
[0]不能省略——即使只有一项，jsonpath-ng不自动展开数组，$.data.items.meta.status会返回空 - 键名含空格或特殊字符（如
"user name"）必须用['user name']，但注意单引号是字符串一部分，不是语法符号 - 用
find()后检查result是否为空列表，别直接result[0].value，否则IndexError
处理动态数组索引或未知层级时，用递归下降操作符
当API结构不确定（比如日志里trace字段可能在任意层级），用..比硬写路径更可靠。例如：$..trace_id能匹配所有叫trace_id的字段，无论嵌套多深。
-
..性能较差，大数据响应慎用；实测10MB JSON里执行一次..查询比固定路径慢3–5倍 - 匹配到多个结果时，
find()返回列表，需自行判断取第一个还是遍历——没业务逻辑兜底的话，容易取到错误上下文的数据 - 无法用
..跳过中间必选层级，比如$..items..status不会匹配{"items": {"status": "ok"}}，因为items是对象不是数组，得写成$.items.status或$..items?.status（?表示可选，但需jsonpath-ng1.6.0+
从requests响应中直接提取，别先loads再查
常见错误：把response.text用json.loads()转成Python dict，再喂给JsonPath——这一步多余且危险。JSON字符串里可能含Unicode转义或特殊编码，loads()可能失败，而jsonpath-ng内部已处理解码。
- 正确做法是：
jsonpath_expr.find(response.json())，response.json()由requests保证解码正确 - 如果API返回非JSON（如HTTP 500带HTML错误页），
response.json()抛JSONDecodeError，必须try/except捕获，不能指望JsonPath处理 - 响应体极大时，别用
response.json()全加载到内存，改用流式解析（但JsonPath不支持流，此时得换ijson库配合手动导航）
response.json()前几层结构，用jsonpath-ng的parse()加find()分步验证，比盲目改路径快得多。大量免费API接口：立即使用
涵盖生活服务API、金融科技API、企业工商API、等相关的API接口服务。免费API接口可安全、合规地连接上下游，为数据API应用能力赋能！
