PHP读取Pixso JSON需用json_decode()解析，注意BOM、逗号、编码及图层类型兼容性，提取时区分frame坐标、文本内容位置、样式映射与单位处理。
PHP如何读取Pixso导出的JSON图层数据
Pixso导出的设计稿（如通过「导出 JSON」功能）本质是结构化的嵌套对象，PHP 用 json_decode() 就能解析，但必须注意：Pixso 的 JSON 默认含 Unicode 转义（如 "\u4f60\u597d"），而 PHP 7.4+ 的 json_decode() 默认支持，无需额外处理；若用旧版本，需确保传入 JSON_UNESCAPED_UNICODE 标志，否则中文会变成乱码。
常见错误现象：json_decode() 返回 null，大概率是 JSON 文件开头有 BOM 或末尾多逗号。建议先用 file_get_contents() 读取后，用 trim() 去首尾空白，再用 json_last_error() 检查错误类型。
- 导出时务必选择 Pixso 的「标准 JSON」格式，而非「Sketch 兼容模式」——后者字段名和嵌套逻辑不同，
layer.name可能变成layer._name - 图层坐标系以左上为原点，
frame.x和frame.y是相对画布的位置，不是 CSS 中的 top/left - 文本图层内容藏在
style.text或textData.content字段下，具体取决于 Pixso 版本，建议先print_r(array_keys($layer))看一眼结构
提取图层尺寸与位置时要注意哪些单位陷阱
Pixso 导出的 frame 字段中 width/height/x/y 全是像素值（整数），但某些组件（如 Auto Layout 容器）可能带小数，PHP 浮点运算本身没问题，但后续若转成 CSS 或生成图片，得主动 round() 或 intval() ——尤其当你要用 imagettfbbox() 计算文字宽高时，传浮点会报 Warning。
容易踩的坑：rotation 字段单位是「度」，但部分老版 Pixso 会输出弧度（极少见），判断方式很简单：如果数值绝对值 > 360 或在 -6.28~6.28 之间，大概率是弧度，需乘 180 / M_PI 转换。
立即学习“PHP免费学习笔记（深入）”；
- 缩放后的图层，
frame值已是最终渲染尺寸，不需再乘scaleX/scaleY——这些字段只在变换矩阵（transform数组）里存在，日常提取宽高直接读frame即可 - 隐藏图层（
isVisible === false）仍会出现在 JSON 中，如需过滤，得手动检查isVisible字段，不能依赖是否存在 - 导出设置里若勾选「合并字体样式」，
style.fontSize可能是字符串（如"14px"），需用正则提取数字，而不是直接(int)强转
用PHP批量生成CSS样式表时怎么映射Pixso文本样式
Pixso 的文本样式字段分散在 style、textData、fontFamily 等多个层级，且 fontFamily 值可能是「PingFang SC」或「"PingFang SC", "Helvetica Neue" 这种带引号和备选字体的字符串。PHP 处理时别直接拼进 CSS，先用 str_replace(['"', "'"], '', $family) 清理，再 explode(', ', ...) 分割备用字体。
性能影响：如果图层超 200 个，逐个 foreach 提取样式再拼 CSS 字符串，比先收集所有唯一样式再生成 class 规则慢 3–5 倍。建议用二维数组归类：$styles[md5(serialize($relevant_style))] 做键，避免重复规则。
-
style.color是 RGBA 数组（如[255, 128, 0, 1]），需转成rgba(255,128,0,1)；若 alpha=1，可简化为rgb(255,128,0)提升可读性 -
textData.align值是字符串"left"/"center"/"right"，但 CSS 中text-align值一致，可直译；注意 Pixso 没有"justify"，别硬加 - 行高（
lineHeight）字段可能为null、数字或字符串"1.5"，统一用floatval()转，再补单位em（CSS 中无单位默认是倍数）
遇到「Layer type not supported」这类解析失败怎么办
Pixso 新增图层类型（如「3D 图层」「视频占位符」「变量组件」）不会向后兼容旧导出格式，JSON 中会出现 type: "video" 或 type: "variableInstance"，而你的 PHP 解析逻辑若只认 "text"、"rectangle"、"group"，就会跳过或报错。此时不要硬改代码适配，先确认业务是否真需要处理这些类型——多数自动化场景只需跳过非关键图层。
最稳妥的做法：给每个 type 分支加 default 分支，记录日志并继续循环，而不是 throw new Exception()。例如：
switch ($layer['type']) {
case 'text': handleText($layer); break;
case 'rectangle': handleRect($layer); break;
default: error_log("Unsupported layer type: " . $layer['type'] . " in file " . $filename); break;
}
- 某些企业版 Pixso 导出的 JSON 含
__pixso_internal字段，纯元数据，体积大且无业务意义，解析前可用unset($data['__pixso_internal'])减少内存占用 - 图层 ID（
id）是字符串，但部分老脚本误当整数用is_int()判断，结果永远 false —— 应该用is_string()或正则/^node_.+/匹配 - 导出 JSON 体积超过 5MB 时，
json_decode(file_get_contents(...))可能 OOM，改用json_decode(stream_get_contents(fopen(...)), true)流式读取更稳
图层嵌套深度没有硬限制，但 PHP 默认 max_input_nesting_level 是 64，Pixso 复杂文件可能超，需在脚本开头设 ini_set('max_input_nesting_level', 256)，否则 json_decode() 静默失败。
