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 高度足够（对lineshape，至少设android:layout_height="2dp"） - 在
rectangleshape 中用虚线边框时，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 就等于没设虚线。
