jsonb_set更新嵌套键值时路径必须为text[]类型，如ARRAY['user','name']或'{user,name}'；不支持点号字符串、通配符或数组索引表达式；更新数组元素需显式指定下标如ARRAY['items','0','status']；用NULL（非'null'）可删除字段；批量更新宜用CTE预计算避免性能问题。
jsonb_set 更新单个嵌套键值时路径必须是字符串数组
直接传入点号分隔的字符串（比如 'user.name'）会报错，jsonb_set 的第二个参数要求是 text[] 类型。常见错误是写成 jsonb_set(data, 'user.name', '"Alice"')::jsonb，结果提示“function jsonb_set(jsonb, text, jsonb) does not exist”。
正确做法是用花括号或 ARRAY 构造路径：
jsonb_set(data, ARRAY['user', 'name'], '"Alice"')jsonb_set(data, '{user,name}', '"Alice"')
注意：路径中每个元素都是 key 名，不支持通配符、索引表达式（如 'items[0].id'），也不支持负数下标。
更新数组内对象的字段需要先定位到数组项
如果 JSONB 里存的是对象数组（如 {"items": [{"id": 1, "status": "pending"}]}），想改第一个 item 的 status，不能直接写 ARRAY['items', 'status'] —— 这会试图在 items 数组上设 status 字段，而数组没有字段。
必须显式指定数组下标（从 0 开始），且下标要作为路径的一部分：
- 更新第 0 个 item 的 status：
jsonb_set(data, ARRAY['items', '0', 'status'], '"done"') - 如果下标是变量（比如来自子查询），用
||拼接：jsonb_set(data, ARRAY['items'] || idx::text || ARRAY['status'], '"done"')
若不确定下标是否存在，jsonb_set 默认不会创建缺失的中间结构；加第四个参数 true 可启用“自动创建”模式，但对数组下标无效 —— 超出当前长度的下标仍会报错。
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
用 jsonb_set 替换整个子对象时注意 null 和缺失字段的区别
当目标路径已存在，jsonb_set 直接覆盖；但如果路径不存在，默认行为是不修改原值（除非开启 create_missing := true）。容易混淆的是：null 值和“字段不存在”在 JSONB 中语义不同。
例如原数据为 {"config": {"timeout": 30}}，执行 jsonb_set(data, ARRAY['config', 'retry'], 'null') 后变成 {"config": {"timeout": 30, "retry": null}}；而想彻底删掉 retry 字段，得用 jsonb_set(data, ARRAY['config', 'retry'], NULL)（注意是 SQL NULL，不是字符串 'null'）。
关键区别：
-
'null'→ 插入 JSONnull值（字段保留） -
NULL（无引号）→ 删除该路径对应字段（需配合create_missing := false默认行为）
批量更新多条记录时慎用子查询返回的 jsonb_set 结果
在 UPDATE ... SET col = jsonb_set(...) 中嵌套复杂子查询（比如从另一张表查新值），PostgreSQL 会为每一行重新计算子查询，可能引发性能抖动。尤其当子查询含 JOIN 或聚合时，实际执行计划可能远超预期。
更稳的做法是先用 CTE 预算好所有新值，再 JOIN 更新：
WITH new_values AS ( SELECT id, jsonb_set(data, ARRAY['meta', 'updated_by'], to_jsonb(user_id)) AS new_data FROM orders o JOIN users u ON o.owner = u.id ) UPDATE orders SET data = nv.new_data FROM new_values nv WHERE orders.id = nv.id;
另外，jsonb_set 是 immutable 函数，但频繁更新大 JSONB 字段仍会触发 TOAST 行膨胀，长期高频写入建议拆出关键字段到普通列。
