Android shape stroke dashGap XML绘制虚线间隔设置

dashgap 是控制虚线空白长度的属性，必须与 dashwidth 同时设置且均大于0才生效；单独设置或任一为0/无效单位/拼写错误均导致实线渲染。

dashGap 是什么，为什么设了没反应

在 android 的 shape xml 中，dashGap 控制虚线之间空白的长度，但它必须和 dashWidth 一起出现才生效。单独写 dashGap 不会画出虚线，系统直接当实线处理。

• dashWidth 和 dashGap 必须同时设置，且都 > 0，否则退化为实线
• 单位只能是 dp 或 px，不支持 sp 或无单位数值
• 如果父 View 启用了硬件加速（默认开启），某些低端机型可能渲染异常，表现为虚线变实或错位

XML 中正确写法与常见拼写错误

虚线属性必须放在 <stroke></stroke> 标签内，且命名严格区分大小写。最容易错的是把 dashGap 写成 dashgap、dash_gap 或漏掉 android: 前缀。

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

• 缺 android:dashWidth → 虚线不显示
• 值写成 "10"（无单位）→ 编译通过但运行时被忽略
• 写成 dashgap="6dp"（少 android:）→ 编译报错或静默失效

dashGap 太小或为 0 的实际表现

当 dashGap ≤ 0 或过小时，不同 Android 版本行为不一致：5.0+ 通常强制转为实线；4.4 及以下可能渲染出极密“伪虚线”，肉眼难以分辨间隙。

• dashGap="0dp" ≠ 紧密虚线，而是等效于未设置虚线参数
• 建议最小值设为 1dp，再小就失去“虚”的语义
• 若需细密虚线，优先调小 dashWidth，保持 dashGap ≥ dashWidth，避免渲染抖动

View 边框虚线在高缩放比屏幕下变实

部分设备（尤其是 3x+ density 屏幕）会因像素对齐问题，把本该是 gap 的区域渲染成半透明像素，视觉上连成实线。这不是 XML 写错了，而是光栅化阶段的精度丢失。

• 临时缓解：把 dashWidth 和 dashGap 都设为偶数 dp（如 8dp/4dp），减少 sub-pixel 渲染误差
• 根本解法：改用 canvas.drawLine() 手动画虚线，或使用 MaterialDivider 等兼容性更好的组件
• 注意：ConstraintLayout 的 app:layout_constraintWidth_default="wrap" 类属性可能干扰 shape 尺寸计算，导致 dash 效果压缩失真

虚线效果高度依赖底层 Skia 渲染路径，XML 层面能调的只有那两个参数，其余都得靠实测 —— 同一套值在 Pixel 和 Redmi 上可能看起来完全不同。