Toolbar自定义AppBar：标题区域设计视图可见但运行时不显示求助

嘿，我来帮你搞定这个头疼的问题！你遇到的情况其实挺常见——设计视图里标题明明好好的，一运行就被自定义布局给盖住了，核心原因就是自定义布局的布局参数没适配Toolbar的内部规则，导致它抢占了原本属于标题和菜单的空间。设计视图因为没有完全模拟Toolbar的运行时布局逻辑，所以才会看起来正常。

常见问题点&针对性解决方案 #

1. 自定义布局的高度/布局参数错误

很多时候我们会随手给自定义布局设置android:layout_height="match_parent"，再加上默认的普通布局参数（比如LinearLayout.LayoutParams），这会让自定义布局直接占满整个Toolbar，把标题彻底压在底下。

修复方式：

• 给自定义布局设置适配Toolbar的布局规则：通过android:layout_gravity指定它的位置（比如左侧、右侧），避免占满中间标题区
• 调整布局高度为wrap_content，或者保留match_parent但搭配合适的layout_gravity让它只占据部分空间

举个修改后的布局示例：

<androidx.appcompat.widget.Toolbar
    android:id="@+id/toolbar"
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize"
    android:background="?attr/colorPrimary">

    <!-- 自定义布局：固定在左侧，不占用中间标题区域 -->
    <LinearLayout
        android:layout_width="wrap_content"
        android:layout_height="match_parent"
        android:layout_gravity="center_vertical|start"
        android:orientation="horizontal"
        android:paddingHorizontal="8dp">
        
        <ImageView
            android:layout_width="24dp"
            android:layout_height="24dp"
            android:src="@drawable/ic_custom_icon"/>
    </LinearLayout>

</androidx.appcompat.widget.Toolbar>

2. 没给Toolbar预留标题空间

如果你的自定义布局必须占满Toolbar，但还要保留系统标题，可以通过调整Toolbar的contentInset属性，给标题挤出位置：

<androidx.appcompat.widget.Toolbar
    android:id="@+id/toolbar"
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize"
    android:background="?attr/colorPrimary"
    app:contentInsetStart="60dp" <!-- 给左侧自定义布局留出空间，标题从这里开始显示 -->
    app:contentInsetEnd="16dp">

    <!-- 自定义布局内容 -->
</androidx.appcompat.widget.Toolbar>

3. Activity代码未正确配置Toolbar

别忘了在代码里把Toolbar设置为SupportActionBar，并且显式设置标题——有时候系统标题会因为布局遮挡默认不显示，手动设置能强制让它出现：

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    setContentView(R.layout.activity_main);
    
    Toolbar toolbar = findViewById(R.id.toolbar);
    setSupportActionBar(toolbar);
    // 显式设置标题，避免被遮挡后默认不显示
    Objects.requireNonNull(getSupportActionBar()).setTitle("我的自定义标题");
}

额外小技巧：完全自定义标题区域 #

如果你觉得系统标题不够灵活，干脆把标题直接放到自定义布局里，然后隐藏系统自带的标题：

getSupportActionBar().setDisplayShowTitleEnabled(false);

这样你就能完全控制标题的样式、位置，再也不用担心被遮挡啦。

内容的提问来源于stack exchange，提问作者Mr.Eddart