viewportWidth定义pathData坐标系的参考单位，非显示尺寸或缩放比例；需与pathData原始设计尺寸匹配（如24×24图标应设viewportWidth="24"），否则导致图形错位、截断或动画异常。
viewportWidth 决定的是 pathData 坐标系的“画布大小”
它不是最终显示尺寸，也不是缩放比例，而是给 pathData 里所有数字（比如 M10,20 L30,40）提供一个默认参考单位。当你写 android:viewportWidth="100"，那 pathData 中的 10 就代表这个“100单位宽”的视口里的 10 单位 —— 类似 SVG 的 viewBox。
常见错误是以为改 viewportWidth 能直接放大图形：其实它只重定义了坐标解释规则；真正影响显示大小的是 android:width/android:height（或 layout 中的尺寸约束）。
- 若
pathData是基于 24×24 设计的（如 Material 图标），就该设viewportWidth="24"和viewportHeight="24"，否则路径会拉伸或错位 - 修改
viewportWidth同时没同步调整pathData数值，会导致图形偏移、截断或缩成一团 - Android 渲染时会把整个 viewport 映射到实际绘制区域（由
width/height决定），中间是等比缩放 + 平移，不支持非均匀缩放
viewportWidth 和 pathData 必须配套理解
看一段典型错误：
<vector android:viewportWidth="100" android:viewportHeight="100"> <path android:pathData="M0,0 L24,24"/> </vector>
这里 pathData 本意是画一条 24×24 区域内的对角线，但 viewport 是 100×100，结果线条只占左上角一小块（0–24 占 100 的 24%）。正确做法是让两者匹配：
- 要么改 viewport：
android:viewportWidth="24" - 要么改 pathData：
android:pathData="M0,0 L100,100"（但不推荐，破坏设计源数据） - 工具导出 vector 时（如 Android Studio → New → Vector Asset），默认按原始图标尺寸设 viewport，别手动乱调
不同 viewportWidth 对 trimPathStart 等动画属性的影响
trimPathStart、trimPathEnd 的取值范围是 0–1，它作用于整个 pathData 的长度，而这个“总长度”是按当前 viewport 单位算出来的。也就是说，viewport 改变 → 路径坐标单位变 → 路径几何长度变 → 同样的 trimPathStart="0.5" 截掉的实际像素位置可能不同。
- 如果用脚本批量生成 vector，且依赖 trim 动画，必须保证所有文件 viewport 一致，否则动画节奏错乱
- 调试时可用
adb shell dumpsys activity top | grep -A5 vector粗略观察是否加载异常，但更靠谱的是在 Layout Inspector 里看实际绘制 bounds - Android 7.0+ 对非整数 viewport（如
viewportWidth="24.5"）支持不稳定，一律用整数
兼容性坑：低于 API 21 的 vector 兼容方案绕不开 viewport
使用 AppCompatDelegate.setCompatVectorFromResourcesEnabled(true) 或 VectorDrawableCompat.create() 时，viewport 定义直接影响向后兼容的解析逻辑。旧版本 runtime 不支持动态 viewport 缩放，它会把 pathData 原样映射到目标 view 的 bounds 上，此时 viewport 只起“归一化”作用。
- 如果你的 vector 在低版本上图形模糊或错位，先检查
viewportWidth是否和设计稿原始画布一致 - 避免用
android:width="wrap_content"配合大 viewport —— 这会让兼容层难以推算合理缩放因子，容易触发整数截断误差 - 第三方库（如 Glide 加载 vector）若未显式指定
width/height，也会因 viewport 解析偏差导致渲染异常
viewportWidth 看似只是个数字，但它绑定了路径坐标的语义、动画计算的基础单位、以及跨版本渲染的一致性前提——动它之前，得先确认 pathData 是按谁的尺子画的。
