Android vector path strokeLineCap XML设置线条端点形状

strokelinecap在vectordrawable中不生效的主因是路径过短、被裁剪/缩放或描边过细；需确保strokewidth≥2dp、路径非零长、无缩放变形，且依赖库版本≥appcompat 1.6.1或vectordrawable 1.2.0。

strokeLineCap 在 vector drawable 中不生效？

android 的 strokeLineCap 属性在 <path></path> 标签里写对了，但线条端点还是圆角或方头没变化——大概率是路径本身太短，或者被裁剪/缩放掩盖了端点效果。Vector drawable 渲染时会做路径简化和抗锯齿优化，strokeLineCap 只有在「线段长度明显大于描边宽度」且「未被 android:viewportWidth/Height 压缩变形」时才肉眼可见。

• 确保 android:strokeWidth ≥ 2dp，太细的描边会让 strokeLineCap 几乎不可见
• 避免把 android:pathData 写成单点移动（如 M10,10 L10,10），这种“零长度线段”不触发端点渲染
• 检查父级 <group></group> 是否用了 android:scaleX 或 android:rotation，可能让端点形变失真

strokeLineCap 可用值及对应视觉表现

strokeLineCap 只接受三个字符串值：butt、round、square，没有 inherit 或数字。它只作用于每一段独立线段（L、C、Q 等命令生成的线段）的终点，不控制起点（起点由上一段决定）。

• butt：端点截平，正好停在最后坐标点，不延伸
• round：以最后坐标为中心，画半径为 strokeWidth/2 的半圆
• square：向线段方向外延出一个边长为 strokeWidth 的正方形块

示例：<path android:strokecolor="#000" android:strokewidth="4" android:strokelinecap="square" android:pathdata="M10,10 L50,10"></path> —— 这条横线右端会多出一个 4dp 宽的方块。

为什么在 Android 5.0 以下设备看不到效果？

strokeLineCap 是 VectorDrawableCompat 从 support-v4 23.2.0 开始才支持的属性，低于这个版本的兼容库直接忽略该字段。如果你的 minSdkVersion ≤ 16 且用的是旧版 appcompat，即使 xml 里写了也无效。

• 确认依赖了 androidx.appcompat:appcompat:1.6.1+ 或 androidx.vectordrawable:vectordrawable:1.2.0+
• 避免混用 android: 和 app: 命名空间；矢量图属性必须全用 android: 前缀（不是 app:）
• 真机测试时，别只看 Layout Editor 预览——它常显示错误，务必在目标系统版本上运行验证

替代方案：当 strokeLineCap 不可控时怎么办

如果遇到动态生成 path、或需要精确控制端点形状（比如三角形箭头），硬靠 strokeLineCap 往往不可靠。更稳的办法是把端点“画出来”：

• 用 <group></group> 组合多个 <path></path>：主干用 butt，再单独画一个 round 小圆或 square 矩形盖在末端
• 改用 android:fillColor + android:pathData 描述完整封闭形状，绕过描边端点逻辑
• 对动画中频繁变化的路径，优先考虑用 AnimatedVectorDrawable 控制端点位移，而不是依赖静态 strokeLineCap

真正难的不是设哪个值，而是得意识到：XML 里的 strokeLineCap 是个“尽力而为”的提示，不是像素级保证。端点是否可见、是否变形，取决于路径几何、缩放比例、设备渲染管线，甚至当前 theme 的 android:layerType 设置。