DeepDiff 不适合忽略键的精细控制，因其默认完全跳过路径而非仅忽略值比较，且 exclude_paths 对嵌套同名键缺乏上下文感知；推荐手写递归比对或用 dictdiffer + diff_filter 实现路径前缀匹配的精准忽略。
为什么 DeepDiff 不适合忽略键的精细控制
它默认把忽略键当作“完全跳过该路径”，但实际中常遇到：只想忽略某个键的值差异，却仍要报告其父结构变化；或想忽略某键仅在特定层级生效。DeepDiff 的 exclude_paths 和 exclude_regex_paths 对嵌套同名键（如多处都有 "id"）缺乏上下文感知，容易误删或漏忽略。
用递归函数手动比对 + 白名单/黑名单键控制
核心是自己走一遍嵌套结构，在每层判断当前键是否该忽略——不是跳过整个分支，而是跳过「值比较」，继续递归子结构。这样能保留路径信息、类型差异、缺失键等其他线索。
实操建议：
- 定义忽略规则为字典：
{"user": ["token", "session_id"], "config": ["timestamp"]}，表示只在"user"字典下忽略那两个键 - 递归时传入当前路径（如
["data", "user", "profile"]），用路径前缀匹配规则，避免全局键名冲突 - 对
dict类型，先取交集键做比较，再单独检查左有右无 / 右有左无的键（忽略键不参与“缺失”判定） - 遇到忽略键时，直接跳过值比对，但记录日志：
ignored key 'token' at path ['user']，便于调试
dictdiffer + 自定义 diff_filter 更轻量
dictdiffer 输出的是操作列表（add、change、remove），天然适合过滤。它不自动跳过键，而是让你在 diff 后筛掉不想看的操作。
示例逻辑：
from dictdiffer import diff
result = list(diff(dict1, dict2))
filtered = [
op for op in result
if not (op[0] == 'change' and len(op[1]) >= 2 and op[1][0] == 'user' and op[1][1] in ['token', 'session_id'])
]
注意点：
-
op[1]是路径元组，长度可变，需用len(op[1]) >= N防越界 - 它不报告类型变化（比如
str→int还是标为change），如需区分得额外加类型检查 - 对深层嵌套（如
['a', 'b', 'c', 'd']），用op[1][-1]取末键名可能不准，推荐用路径前缀匹配
性能与兼容性：深拷贝、循环引用、非 JSON 类型
手写递归或 dictdiffer 默认都不处理循环引用，遇到会报 RecursionError。若数据可能含自引用，必须加 seen 集合缓存 id。
常见坑：
-
datetime、Decimal、numpy类型无法直接比较，需预处理转成str或float；DeepDiff内置支持，但自定义方案得自己注册转换器 - 忽略键逻辑若写在递归函数里，每次调用都查规则字典——高频调用时建议提前编译成路径正则或哈希查找表
- Python 3.12+ 的
dict保持插入顺序，但旧版本不保证；若依赖顺序（如列表内 dict 排序敏感），得先标准化键序再比
真正麻烦的从来不是“怎么忽略”，而是“在哪个层级、以什么粒度忽略”——路径匹配逻辑一旦复杂，就很容易漏掉某条嵌套分支里的同名键。
