JSON_TABLE是唯一能真正展开JSON数组为多行的函数，必须用于FROM子句，语法为JSON_TABLE(json_doc, path COLUMNS(col_def)) AS alias，其中path须以[*]结尾，COLUMNS需明确定义类型与路径，其他函数无法生成多行结果。
JSON_TABLE 是唯一能真正“展开”数组的函数
想把 JSON 数组里的每个元素变成一行结果，JSON_TABLE 不是可选项，而是必须用的函数。其他函数如 JSON_EXTRACT、-> 或 JSON_CONTAINS 都只能取值或判断存在性，无法生成多行——强行用子查询或 JOIN 模拟，轻则漏数据，重则触发笛卡尔积爆炸。
它必须出现在 FROM 子句里，结构固定为：
JSON_TABLE(json_doc, path COLUMNS (col_def)) AS alias
其中：json_doc 可以是列名（如 data）、路径提取表达式（如 data->'$.items'），甚至字面量（如 '[1,2,3]'）；path 必须以 [] 结尾（如 '$.tags[]'），写成 '$.tags' 会直接报错 ERROR 3143；COLUMNS 里每个字段需明确类型和路径，比如 tag VARCHAR(50) PATH '$' 表示取当前数组元素本身。
展开后怎么过滤？别在 WHERE 里硬套原始 JSON 字段
常见错误是先写 WHERE JSON_CONTAINS(data, '"vip"', '$.tags')，再试图 JOIN 展开结果——这会导致展开逻辑被绕过，条件实际作用在原始单行上，语义错位。
正确做法是：先展开，再用标准 SQL 过滤展开后的列。例如查所有带 "vip" 标签的用户及其标签序号：
SELECT u.id, jt.tag, jt.idx FROM users u, JSON_TABLE(u.profile, '$.tags[*]' COLUMNS ( idx FOR ORDINALITY, tag VARCHAR(20) PATH '$' )) AS jt WHERE jt.tag = 'vip';
要点：
-
FOR ORDINALITY自动生成递增序号，方便定位第几个元素 - 过滤必须落在
jt.tag上，不是u.profile - 如果数组可能为空或字段为
NULL，加AND JSON_VALID(u.profile)预过滤，避免展开结果为空
对象数组取深层字段，PATH 写法容易错
当数组元素是对象（如 [{"user": {"name": "Alice"}}, {"user": {"name": "Bob"}}]），要取 name，PATH 必须从当前元素根开始写，不能跳级。
使用约定式提交（Conventional Commits）生成标准化的 Git 提交信息。适用于以下场景： (1) 暂存更改时需要提交信息； (2) 审查 diff 时希望获得结构化摘要； (3) 编写 PR 描述或变更日志（changelog）条目； (4) 用户明确要求“为本次更改编写提交信息”。 该功能会分析已暂存/未暂存的 diff，并生成按类型（type）划分范围的提交信息。
错误写法：name VARCHAR(50) PATH '$.name' → 找不到，返回 NULL
正确写法：name VARCHAR(50) PATH '$.user.name'
其他常见陷阱：
- 用
VARCHAR(5)接长度为 8 的字符串，会静默截断，不报错也不警告 - 路径中用了单引号但没转义，比如
PATH '$.desc["key's"]'→ 语法错误，应写成PATH '$.desc."key\'s"' - 数组路径写成
'$[*]'而非'$.items[*]'，当 JSON 是{"items": [...]}时会找不到数据
性能关键：大表 + 大 JSON 字段别硬扛
JSON_TABLE 是解释执行，对每行 JSON 动态解析，没有索引加速。10 万行表 + 平均 50 元素数组，一次展开就是 500 万行中间结果，IO 和内存压力陡增。
生产环境建议：
- 优先在应用层预处理：把数组拆成关联表，用外键代替嵌套
- 若必须保留 JSON，加虚拟列 + 索引，例如：
ALTER TABLE users ADD tags_text TEXT AS (profile->>'$.tags')，再对tags_text建全文索引 - 展开时显式限制列数，避免
SELECT *带出大量无用字段 - 确认 MySQL 版本 ≥ 8.0.4，低于此版本
JSON_TABLE不可用
最易被忽略的一点：JSON 字段内容变更后，虚拟列不会自动更新索引，需要确保写入路径统一走 JSON_SET 或 JSON_REPLACE，而不是直接覆盖整个 JSON 字符串。
