ThinkPHP JSON字段需同时配置$type和$json才能正常工作：$type控制读取时json_decode()，$json控制写入时json_encode()，且字段名必须与数据库列名完全一致；单独配置任一参数或字段名不匹配均导致JSON功能失效。
JSON字段不自动转数组？必须同时配 $type 和 $json
只写 $type = ['data' => 'json']，$model->data 还是字符串；只写 $json = ['data']，写入时直接报 Array to string conversion。ThinkPHP 把读取解码和写入编码拆成两件事，缺一不可。
-
$type控制读取时是否调用json_decode()（但仅当$json也存在时才真正生效） -
$json控制写入前是否调用json_encode()，且会反向触发读取解码逻辑 - 字段名必须和数据库列名完全一致，大小写、下划线都不能错，比如数据库是
user_info，就不能写成userInfo - TP6.0+ 支持
jsonb（PostgreSQL），MySQL 不认这个值，写错就等于没配
写入 JSON 字段时数组被双层编码？别手动 json_encode()
常见错误：赋值前自己 json_encode(['a'=>1])，再塞给 $model->data，结果 TP 再 encode 一次，存库变成 "{\"a\":1}" —— 典型的双重编码。
- 正确做法：直接赋原生数组，
$model->data = ['a' => 1]; $model->save();，TP 在写入前自动json_encode() - 批量赋值同理：
$model->data(['data' => ['x' => 'y']])->save(); - 如果前端传的是 JSON 字符串（如 API 接口），先
json_decode($input['data'], true)，再赋值，不能直接存字符串 - 注意浮点数精度：PHP
json_encode(3.141592653589793)可能输出3.1415926535898，这不是 TP 问题，是底层行为
修改 JSON 数组内部值不生效？必须整体重新赋值
$model->data['name'] = 'new'; $model->save(); 不会更新数据库 —— ThinkPHP 不监听数组内部变化，只检测字段级是否被重新赋值。
Wjs Uploading Video
下载
将一个或多个视频上传至YouTube。当用户想“上传到YouTube”“发YouTube”“批量上传”“upload to YouTube”“post videos to YouTube”或发布到YouTube时使用此技能。
- 安全写法：
$data = $model->data; $data['name'] = 'new'; $model->data = $data; $model->save(); - 更健壮的做法：先用
$model->getData('data')拿原始字符串，json_decode()后操作，避免null或非法 JSON 导致异常 - 如果字段值为
null或空字符串，$model->data返回null，不是空数组，需自行兜底：return $value ?: []; -
toJson()输出时 JSON 字段变回字符串？因为序列化走的是原始数据，不是getAttr()，想保持结构得加到$append或重写toArray()
数据库字段不是 JSON 类型？别硬配 json 类型
MySQL 的 VARCHAR 或 TEXT 字段里存了 {"a":1}，配了 'data'=>'json' 看似能用，但一旦内容含非法 JSON（比如中文乱码、未转义引号），$model->data 就返回 null，且无提示。
立即学习“PHP免费学习笔记（深入）”；
- 确认数据库字段类型：MySQL 5.7+ 建议用原生
JSON类型，兼容性好、支持whereJsonContains()等查询 - 非 JSON 类型字段（如逗号分隔字符串），不要配
json，改用访问器：getTagsAttr()里做explode()，setTagsAttr()里做implode() - 字段名含点号（如
settings.theme）无法用$json声明，只能靠getSettingsAttr()手动处理 - TP8 虽默认对 JSON 类型字段做 decode，但
getData()或直接__get仍可能返回原始字符串，别依赖“默认”行为
$type 和 $json 缺一不可、数组内部修改必须整体赋值——这三处漏掉任何一点，JSON 字段就退化成普通字符串，而且不容易立刻发现。 
