viewportHeight 是无单位的逻辑画布高度，用于定义 pathData 坐标的映射范围；它不是显示高度或 dp 值，必须与 pathData 中最大坐标值一致，否则导致裁剪、错位或失真。
viewportHeight 是什么，不是什么
viewportHeight 不是最终显示高度，也不是 dp 值，它是一个无单位的、纯数值的“逻辑画布高度”。你把它理解成 SVG 里的 viewBox 高度就行——所有 pathData 中的坐标（比如 M10,20）都是在这个虚拟坐标系里定义的。真正渲染多高，由 android:height 决定；而 viewportHeight 只管“比例怎么算”。
常见错误现象：pathData 画出来偏小/错位/被裁剪，八成是 viewportWidth 和 viewportHeight 没跟设计稿原始尺寸对齐，或者和 pathData 里坐标的量级不匹配。
- 如果设计师给的是 100×100 的 SVG，就该设
viewportWidth="100"、viewportHeight="100"，而不是硬改成 24 - 改了
viewportHeight却没同步调整pathData坐标，图形会拉伸或缩放失真 -
viewportHeight和android:height数值相同（比如都写 24），不代表 1:1 显示——关键看单位：android:height含dp，viewportHeight是纯数字
为什么 viewportHeight 必须和 pathData 坐标范围一致
Android 渲染时，会把 pathData 里所有点（如 L50,60）直接映射到 [0, 0] → [viewportWidth, viewportHeight] 这个矩形内。如果 pathData 最大 Y 是 120，但 viewportHeight="24"，那 Y=120 就超出了可视区域，直接被裁掉——你什么也看不到。
使用场景：从 Figma/Sketch 导出 SVG 后手动转 Vector，或用工具（如 svg2vector）生成 XML 时，务必检查导出的 viewportWidth/viewportHeight 是否与原始 SVG 的 viewBox 一致。
- 典型错误：
pathData="M0,0 L100,100"，却配viewportHeight="24"→ 线段终点被截断 - 正确做法：先看
pathData中最大 X/Y 值，取整后设为viewportWidth/viewportHeight（例如 max X=98.5 → 设 99 或 100） - 没有“标准值”，只有“匹配值”：24、100、512 都可以，只要和路径数据量级一致
viewportHeight 和 android:height 的关系怎么调才不翻车
viewportHeight 控制“比例基准”，android:height 控制“最终大小”，二者共同决定缩放比。比如 viewportHeight="100" + android:height="50dp"，意味着 1 个逻辑单位 = 0.5dp；若改成 android:height="100dp"，就变成 1:1。
性能 / 兼容性影响：这个比例关系完全在运行时计算，不耗额外资源；但若 viewportHeight 设得过大（如 10000），而 pathData 只用了前 100 单位，会导致精度冗余，虽不影响功能，但增加 XML 体积和可读性负担。
- 推荐组合：
viewportHeight="24"对应android:height="24dp"（1:1，最易调试） - 适配大图时：保持比例，比如图标原始是 100×100，要显示为 48dp 高 →
viewportHeight="100"+android:height="48dp" - 千万别混用单位：
viewportHeight="24.0"没问题，但android:height="24"（缺单位）会编译报错：error: No resource identifier found for attribute 'height' in package 'android'
修改 viewportHeight 后 pathData 怎么同步调整
一般不需要手动调 pathData——只要原始 SVG 转换正确，工具生成的 XML 已完成坐标归一化。但如果你手写或编辑过路径，又改了 viewportHeight，就得按比例缩放所有数值。
例如：原 viewportHeight="24"，pathData="M0,0 L24,24"；现在想迁移到 viewportHeight="48"，就要把所有 Y 值 ×2 → M0,0 L48,48。X 同理（按 viewportWidth 比例）。
- 快捷方式：用正则批量替换（谨慎！先备份）：
([MLHVQCTAZ])\s*(\d+\.?\d*)\s*,\s*(\d+\.?\d*)→ 替换为对应缩放后的坐标 - 更安全的做法：用 Android Studio 的 “Vector Asset Studio” 重新导入 SVG，它会自动重算 viewport 和 path
- 注意字母大小写：
m10,10（相对）不能直接乘，必须先还原成绝对坐标再缩放，否则路径错乱
最常被忽略的一点：group 里的 translateY、pivotY 等属性，单位也是 viewport 坐标系——改了 viewportHeight，这些值也得同比例调整，否则动画或镜像会偏移。
