如何消除Android Canvas绘制文本时的白色轮廓

核心排查与修复步骤 #

• 清除阴影设置：最常见的诱因是意外启用了文字阴影——哪怕你没主动配置，第三方代码或默认逻辑也可能修改该属性，直接调用clearShadowLayer()强制清除所有阴影配置。
• 重置Paint的Stroke属性：即便设置了Style.FILL，若之前给Paint配置过strokeWidth或strokeColor，残留属性仍可能干扰渲染，需强制重置为透明色与0宽度。
• 严格绘制顺序：先绘制灰色背景，再绘制黑色文本，避免图层叠加逻辑产生异常边缘。

完整代码示例 #

// 初始化文本绘制Paint
val textPaint = Paint().apply {
    color = Color.BLACK
    style = Paint.Style.FILL // 仅填充模式，排除描边干扰
    textSize = 48f
    isAntiAlias = true // 保留抗锯齿，避免生硬锯齿边缘
    clearShadowLayer() // 强制清除所有阴影配置
    strokeWidth = 0f // 重置描边宽度
    strokeColor = Color.TRANSPARENT // 描边设为透明
    setHinting(Paint.HINTING_ON) // 优化文字渲染精度
}

override fun onDraw(canvas: Canvas) {
    super.onDraw(canvas)
    // 第一步：绘制灰色背景
    canvas.drawColor(Color.GRAY)
    // 第二步：绘制黑色文本
    canvas.drawText("目标文本内容", 100f, 200f, textPaint)
}

额外排查项 #

• 检查Xfermode配置：若Paint的xfermode被设置为非默认值，可能导致颜色混合异常，可通过textPaint.xfermode = null重置。
• 避免重复绘制：排查自定义View的onDraw是否被多次触发，或文本被重复绘制叠加出异常边缘。
• 抗锯齿误解：如果是抗锯齿产生的轻微灰度边缘（非纯白色），属于正常平滑效果；若要完全消除可关闭isAntiAlias = false（但会出现生硬锯齿，不推荐）。

内容的提问来源于stack exchange，提问作者Harry