Android shape stroke dashWidth XML绘制虚线的实线长度

dashwidth 控制虚线中实线段的像素宽度，必须与 dashgap 同时大于 0 才生效，且依赖 android:strokewidth；xml 中使用需注意单位统一为 dp，代码中须用 dashpatheffect 实现。

dashWidth 控制的是虚线中“实线段”的长度

很多人以为 dashWidth 是“空隙长度”或“整个虚线周期”，其实它明确指每一段实线的像素宽度。比如 dashWidth="4" 就是画 4px 长的实线，再画 dashGap="2" 的空白，循环下去。

常见错误现象：stroke 看起来像实线、断断续续不均匀、甚至完全不显示虚线——多数是因为 dashWidth 和 dashGap 同时为 0（默认值），或只设了其中一个。

• dashWidth 和 dashGap 必须**同时大于 0** 才能生效，缺一不可
• 若只写 android:dashWidth="4"，dashGap 仍为 0，结果仍是实线
• Android 4.0+ 才支持 dashWidth/dashGap；低于 API 14 会静默忽略，无报错

XML 中必须配合 android:strokeWidth 使用

虚线本质是描边，所以 android:strokeWidth 是前提。没有它，哪怕 dashWidth 设得再准，也不会渲染出任何线条。

使用场景：自定义 shape 作背景、分隔线、按钮边框等。注意：不能直接用在 View 的 background 属性里就指望自动虚化——必须确保该 shape 是 layer-list 或独立 drawable，且被正确引用。

• android:strokeWidth 决定整体线宽，dashWidth 只控制其中实线部分的长度
• 例如 strokeWidth="2" + dashWidth="6" + dashGap="2"：每 8px 周期里，画 6px 实线 + 2px 空白，整条线粗 2px
• 如果 strokeWidth 太小（如 1），在高密度屏上可能因抗锯齿导致虚线模糊或断点粘连

实际 XML 示例与关键参数组合

下面是一个能稳定生效的虚线 shape 定义：

<shape xmlns:android="http://schemas.android.com/apk/res/android"     android:shape="line">     <stroke         android:width="2dp"         android:color="#666"         android:dashWidth="6dp"         android:dashGap="4dp" /> </shape>

说明：dashWidth="6dp" → 每段实线长 6dp；dashGap="4dp" → 空白段长 4dp；周期为 10dp。注意单位统一用 dp，避免在不同屏幕密度下缩放失真。

• 不要混用 px 和 dp，尤其 dashWidth 用 px 会导致高密度屏上虚线过密甚至糊成实线
• 若用于 View 的 android:background，需确认该 View 高度足够（对 line shape，至少设 android:layout_height="2dp"）
• 在 rectangle shape 中用虚线边框时，dashWidth 从左上角起始绘制，四个边共用同一相位，不会自动对齐拐角

canvas drawLine 绘制虚线时，dashWidth 不适用

这是最容易混淆的点：dashWidth 是 XML shape 的专属属性，**纯代码中调用 canvas.drawLine() 或 Paint.setPathEffect() 时完全无效**。

如果你在自定义 View 里动态画虚线，必须用 DashPathEffect：

Paint paint = new Paint(); paint.setStyle(Paint.Style.STROKE); paint.setStrokeWidth(2f); float[] intervals = {6f, 4f}; // 实线6px、空隙4px paint.setPathEffect(new DashPathEffect(intervals, 0));

注意：DashPathEffect 的数组是交替的实/空长度，第二个参数是 phase（偏移），不是 dashGap。

• XML 的 dashWidth/dashGap 和代码里的 DashPathEffect 是两套机制，不能互相替换或混用
• PathEffect 在硬件加速开启时部分机型可能不生效（尤其是旧 Android 版本），可临时加 setLayerType(LAYER_TYPE_SOFTWARE, NULL)
• XML 虚线无法做旋转或缩放动画，而代码绘制的虚线可通过矩阵实时调整，灵活性更高

虚线的“实线长度”由 dashWidth 直接决定，但它永远不是孤立参数——它依赖 dashGap 的配合、受 strokeWidth 的物理约束、在不同载体（XML vs Canvas）中完全不互通。最常被忽略的是：没设 dashGap 就等于没设虚线。