Android圆形图片边框适配问题：同尺寸边框与边距为何不生效？

首先，咱们来分析你遇到的问题：你用LinearLayout嵌套ShapeableImageView的方式，理论上尺寸计算是对的，但出现边框需要调大margin才显示的情况，大概率是像素对齐偏差或者视图层级遮挡导致的——比如在某些密度的设备上，dp转像素后出现非整数，或者ImageView的边缘刚好和环形边框的内边缘完全重合，导致边框被图片覆盖。

下面给你两种更可靠的实现方式，无需反复调整边距，适配性拉满：

方案一：用LayerList作为ImageView背景（推荐，无需嵌套布局） #

这种方式直接把环形边框和内部占位整合到一个drawable里，彻底避免布局嵌套的适配问题。

1. 创建环形边框的LayerList drawable（drawable/gold_circle_frame.xml）：

<?xml version="1.0" encoding="utf-8"?>
<layer-list xmlns:android="http://schemas.android.com/apk/res/android">
    <!-- 外层环形渐变边框 -->
    <item>
        <shape android:shape="ring"
            android:thickness="@dimen/all_time_best_frame_thickness"
            android:useLevel="false">
            <gradient
                android:startColor="@color/gold_gradient_start"
                android:centerColor="@color/gold_gradient_end"
                android:endColor="@color/gold_gradient_start"
                android:angle="180" />
        </shape>
    </item>
    <!-- 内部透明占位，确保边框不会被图片覆盖 -->
    <item android:padding="@dimen/all_time_best_frame_thickness">
        <shape android:shape="oval">
            <solid android:color="@android:color/transparent" />
        </shape>
    </item>
</layer-list>

2. 修改ShapeableImageView的布局，去掉外层LinearLayout：

<com.google.android.material.imageview.ShapeableImageView
    android:id="@+id/gold_photo"
    android:layout_width="@dimen/all_time_best_total_size"
    android:layout_height="@dimen/all_time_best_total_size"
    android:background="@drawable/gold_circle_frame"
    android:padding="@dimen/all_time_best_frame_thickness"
    android:scaleType="centerCrop"
    app:shapeAppearanceOverlay="@style/CircleImageView" />

3. 补充对应的dimen值：

<dimen name="all_time_best_photo_size">70dp</dimen>
<dimen name="all_time_best_frame_thickness">5dp</dimen>
<!-- 总尺寸 = 图片尺寸 + 2*边框厚度 -->
<dimen name="all_time_best_total_size">80dp</dimen>

为什么这个方案可靠？

• 边框和图片的尺寸关系通过LayerList和padding严格约束，不会出现遮挡
• 无需嵌套布局，减少视图层级，性能更好
• 所有尺寸用dimen统一管理，适配不同密度设备毫无压力

方案二：用ShapeableImageView自带的Stroke（适配渐变边框需小技巧） #

如果想直接用Material组件的原生能力，纯色边框可以直接用strokeWidth和strokeColor，但渐变边框需要绕个小弯：

1. 先创建一个渐变的Drawable（drawable/gold_gradient.xml）：

<?xml version="1.0" encoding="utf-8"?>
<shape xmlns:android="http://schemas.android.com/apk/res/android"
    android:shape="oval">
    <gradient
        android:startColor="@color/gold_gradient_start"
        android:centerColor="@color/gold_gradient_end"
        android:endColor="@color/gold_gradient_start"
        android:angle="180" />
</shape>

2. 创建一个ColorStateList，引用这个渐变Drawable（color/gold_stroke_color.xml）：

<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:drawable="@drawable/gold_gradient" />
</selector>

3. 最后在ShapeableImageView里设置：

<com.google.android.material.imageview.ShapeableImageView
    android:id="@+id/gold_photo"
    android:layout_width="@dimen/all_time_best_total_size"
    android:layout_height="@dimen/all_time_best_total_size"
    android:padding="@dimen/all_time_best_frame_thickness"
    android:scaleType="centerCrop"
    app:shapeAppearanceOverlay="@style/CircleImageView"
    app:strokeWidth="@dimen/all_time_best_frame_thickness"
    app:strokeColor="@color/gold_stroke_color" />

注意： 这种方式需要确保你的Material Components版本足够新（建议1.4.0+），避免兼容性问题。

最后给你解释下原来方案的问题：你用LinearLayout的wrap_content + ImageView的margin，虽然尺寸计算逻辑上是对的，但在实际渲染时，不同设备的像素密度可能导致dp转像素后出现小数，进而让ImageView的边缘和环形边框的内边缘出现重叠或偏移，导致边框被遮挡。而上面两种方案通过padding或LayerList的约束，从根源上避免了这种问题。

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