自定义SpecialTextInputLayout在Android预览中不显示，真机运行正常

我之前也碰到过一模一样的情况——真机跑起来完全正常，但Android Studio的布局预览里自定义View就是一片空白，属实有点影响开发效率。咱们一步步来排查修复：

1. 检查自定义View的构造函数实现 #

Android Studio预览时会优先调用带Context和AttributeSet参数的构造函数，如果你的SpecialTextInputLayout或者内部的Clearable EditText没正确实现这个构造方法，就会直接导致预览失败。

确保你的自定义View类里包含以下构造方法：

// Java版本
public SpecialTextInputLayout(Context context, AttributeSet attrs) {
    super(context, attrs);
    init(context, attrs); // 统一初始化逻辑
}

// 最好同时实现带默认样式的构造函数，覆盖所有初始化场景
public SpecialTextInputLayout(Context context, AttributeSet attrs, int defStyleAttr) {
    super(context, attrs, defStyleAttr);
    init(context, attrs);
}

如果用Kotlin的话：

constructor(context: Context, attrs: AttributeSet?) : super(context, attrs) {
    init(context, attrs)
}

constructor(context: Context, attrs: AttributeSet?, defStyleAttr: Int) : super(context, attrs, defStyleAttr) {
    init(context, attrs)
}

2. 跳过预览模式下的运行时专属代码 #

如果你的自定义View在onMeasure、onDraw或者初始化逻辑里调用了只有真机环境才有的API（比如获取系统服务、访问本地存储、调用第三方SDK等），预览时就会因为报错而无法渲染。

可以通过isInEditMode()方法判断当前是否处于预览模式，针对性跳过这些代码：

@Override
protected void onMeasure(int widthMeasureSpec, int heightMeasureSpec) {
    if (isInEditMode()) {
        // 预览模式下设置一个默认尺寸，避免崩溃
        setMeasuredDimension(MeasureSpec.getSize(widthMeasureSpec), 100);
        return;
    }
    // 正常的测量逻辑
    super.onMeasure(widthMeasureSpec, heightMeasureSpec);
}

初始化方法里也可以加上判断：

private void init(Context context, AttributeSet attrs) {
    if (isInEditMode()) {
        // 预览模式下只做基础初始化，比如加载布局
        inflate(context, R.layout.layout_special_text_input, this);
        return;
    }
    // 正常的运行时初始化逻辑，比如设置输入监听、绑定数据等
}

3. 检查自定义属性的解析逻辑 #

你用到了app:sethint="@string/user_name"这个自定义属性，要确保属性解析过程没有出错：

• 首先确认res/values/attrs.xml里正确定义了该属性：

<declare-styleable name="SpecialTextInputLayout">
    <attr name="sethint" format="string"/>
</declare-styleable>

• 然后在自定义View的初始化方法里正确解析并使用属性：

private void init(Context context, AttributeSet attrs) {
    TypedArray ta = context.obtainStyledAttributes(attrs, R.styleable.SpecialTextInputLayout);
    try {
        String hintText = ta.getString(R.styleable.SpecialTextInputLayout_sethint);
        if (hintText != null) {
            // 将hint设置给内部的Clearable EditText
            mClearableEditText.setHint(hintText);
        }
    } finally {
        ta.recycle(); // 必须回收TypedArray，避免内存泄漏
    }
}

4. 清理IDE缓存并重启 #

有时候只是Android Studio的缓存出了问题，试试这个操作：

• 点击顶部菜单栏File -> Invalidate Caches...
• 勾选Invalidate and Restart，等待IDE重启后再查看预览

5. 单独排查内部布局 #

如果SpecialTextInputLayout是通过inflate加载内部布局实现的，先单独预览这个内部布局文件，确认它能正常显示——如果内部布局里也引用了有问题的自定义View，那外层的预览自然也会失败。

按照上面的步骤排查下来，基本就能解决预览不显示的问题了。我上次就是因为在自定义View初始化里调用了一个只有真机才有的系统服务，加上isInEditMode()判断后就正常显示了。

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