Looka导出JSON颜色字段名不固定，需先用array_keys()确认键名并isset()检查；十六进制颜色需ltrim去#、ctype_xdigit验证；RGB需sscanf转HEX；解码前须校验BOM和编码，检查json_last_error()；深色模式需手动调暗RGB并处理极值。
Looka导出的JSON里颜色字段名不固定，primary和secondary可能不存在
Looka生成的品牌包JSON结构松散，实际字段名取决于设计时选的配色方案类型。常见但非必然的键是primaryColor、accentColor、neutralColor，甚至出现color_1这种编号命名。硬写$data['primary']会直接触发Undefined index警告。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 先用
array_keys($data)打印顶层键，确认真实字段名，别猜 - 用
isset()逐个检查候选键，优先级按业务需要定（比如先找primaryColor，再 fallback 到color_1） - 别依赖
json_decode($json, true)后的数组深度——有些颜色嵌在logo或styleGuide子结构里
十六进制颜色值带#前缀，PHP字符串处理时容易漏掉校验
Looka输出的primaryColor值形如"#2a5dc2"，但部分旧版导出或API响应可能返回无#的"2a5dc2"，甚至混入RGB格式"rgb(42, 93, 194)"。直接传给CSS或数据库会出错。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
ltrim($color, '#')统一去前缀，再用strlen() === 6 && ctype_xdigit()验证是否为合法六位HEX - 遇到
rgb(...)，用sscanf()提取数值后转HEX：sscanf($rgb, 'rgb(%d,%d,%d)', $r, $g, $b)，再sprintf('#%02x%02x%02x', $r, $g, $b) - 别用
filter_var($color, FILTER_SANITIZE_STRING)——它不会修复格式，只会删掉#和括号
json_decode()失败时没有明确错误提示，调试卡在空白页
Looka JSON偶尔含BOM头、UTF-8编码损坏、或末尾多逗号，json_decode()返回null但json_last_error()不报错，导致后续逻辑静默失败。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 解码前先用
mb_detect_encoding($json, ['UTF-8', 'ISO-8859-1'], true)确认编码，再mb_convert_encoding($json, 'UTF-8', 'auto') - 必须检查
json_last_error()：若非JSON_ERROR_NONE，用json_last_error_msg()获取具体原因 - 临时加一句
file_put_contents('/tmp/looka_raw.json', $json)，把原始内容落地，方便用jq或在线工具验证
颜色值需要适配深色模式，但Looka不提供dark变体字段
Looka导出的JSON只有一套颜色，而现代前端常需primary-light和primary-dark两套。硬写darken($color, 20%)在PHP里不可行，CSS变量又没法在服务端动态生成。
实操建议：
立即学习“PHP免费学习笔记（深入）”；
- 用
hex2rgb()函数转成RGB数组，手动调暗：$r = max(0, $r - 51); $g = max(0, $g - 51); $b = max(0, $b - 51) - 避免用
imagecolorat()或GD库——太重，纯计算RGB足够 - 深色模式颜色不能只靠算法压暗，
#000000压完还是黑的，得对极值做特殊判断（比如if ($r ）
实际处理时最麻烦的是字段名漂移和颜色格式混杂，不是语法问题，而是得反复看原始JSON长什么样。别信文档，先var_dump(array_keys($data))。
