Android shape虚线不显示 解决XML画虚线在真机无效

android 5.0（api 21）起shape虚线在真机不显示，主因是硬件加速绕过旧绘制逻辑；需同时设置>0.1dp且单位一致的dashwidth与dashgap，android:width≥2dp，并避免嵌套或自定义ondraw遗漏背景。

Android shape 虚线在真机不显示，本质是 API 21+ 的兼容性断层

不是你写错了，也不是 Designer 预览骗人——从 Android 5.0（API 21）开始，shape 中的 dashWidth 和 dashGap 在某些机型上被系统忽略，尤其是设置了 android:width 小于 2dp 时，虚线直接退化成实线。核心原因是硬件加速渲染路径绕过了旧版虚线绘制逻辑。

stroke 虚线参数必须同时设置 dashWidth 和 dashGap，且不能为 0

只写一个、或设为 0dp，真机大概率不画虚线。系统会静默降级为实线，也不报错。

• dashWidth 和 dashGap 必须都大于 0.1dp（建议 ≥ 1dp）
• 二者单位必须一致（都用 dp，别混用 px）
• 如果 android:width ≤ 1dp，部分厂商 ROM（如华为 EMUI、小米 MIUI）会强制关闭虚线渲染

示例（有效）：

Amazon Nova

亚马逊云科技（AWS）推出的一系列生成式AI基础模型

下载

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

真机调试时优先检查 View 的背景层级和抗锯齿

虚线失效常因叠加渲染覆盖，而非 XML 本身问题。

• 确认该 shape 是直接设为 View 的 android:background，而非嵌套在 layer-list 或 selector 中未显式启用虚线分支
• 若 View 启用了 android:layerType="software"，虚线可能恢复——但这只是验证手段，不能上线用（性能差）
• 某些自定义 View 重写了 onDraw() 且未调用 super.onDraw()，会导致背景完全不绘制

稳妥方案：用 Canvas 手动绘制虚线（API 14+ 兼容）

XML 不可靠时，就别硬扛。用代码控制最稳，还能动态改颜色/间隔。

• 继承 View 或用 Drawable 子类，在 draw() 里用 Paint.setPathEffect(new DashPathEffect(...))
• DashPathEffect 接收 float[]（交替为实线长、空隙长），比 XML 更灵活
• 注意：Paint 必须设 setAntiAlias(true)，否则虚线边缘锯齿严重，看起来像断掉

关键片段：

Paint paint = new Paint();
paint.setColor(0xFF666666);
paint.setStrokeWidth(2f);
paint.setAntiAlias(true);
paint.setStyle(Paint.Style.STROKE);
paint.setPathEffect(new DashPathEffect(new float[]{6f, 4f}, 0));