Android自定义主题下ActionBar自定义标题无法显示的原因问询

我来帮你拆解下这个问题：

你的核心问题出在自定义主题的父类选择上。你用的Theme.MaterialComponents.Light.NoActionBar，从名字就能看出来——这个主题的设计初衷就是禁用系统默认的ActionBar，而你之前用的Theme.MaterialComponents.Light.DarkActionBar是自带完整ActionBar的，这就是为什么切换主题后标题消失的根本原因。

具体原因拆解 #

当你使用NoActionBar系列主题时，系统不会自动为Activity创建ActionBar实例。虽然你在Fragment里通过(activity as AppCompatActivity?)!!.supportActionBar强制获取了ActionBar引用，甚至菜单都能正常显示（这可能是导航组件或Fragment的菜单逻辑做了兼容处理），但此时要么：

• 这个ActionBar引用其实是一个“空壳”，没有正确初始化标题渲染的相关配置；
• 你手动添加了Toolbar作为ActionBar，但主题没有配置标题颜色，导致标题颜色和ActionBar背景色完全一致（比如Light主题下背景是浅色，标题默认也是浅色），看起来像是消失了。

两种解决方案任你选 #

方案1：直接换主题父类（最简单）

如果你只是想保留默认的ActionBar，不需要手动定制Toolbar，那直接把自定义主题的父类换成带ActionBar的版本就行：

<style name="Theme.Custom" parent="Theme.MaterialComponents.Light">
    <!-- 保留你原来的其他自定义属性 -->
</style>

或者如果你喜欢深色ActionBar（和之前的DarkActionBar效果一致），可以用：

<style name="Theme.Custom" parent="Theme.MaterialComponents.Light.DarkActionBar">
    <!-- 你的自定义属性 -->
</style>

方案2：坚持用NoActionBar主题，手动配置Toolbar

如果因为某些原因必须用NoActionBar主题（比如要完全自定义Toolbar的布局），那需要按以下步骤操作：

1. 在MainActivity的布局中添加MaterialToolbar：

<com.google.android.material.appbar.MaterialToolbar
    android:id="@+id/toolbar"
    android:layout_width="match_parent"
    android:layout_height="?attr/actionBarSize"
    android:background="?attr/colorPrimary"
    app:titleTextColor="@color/white" <!-- 这里设置标题颜色，确保和背景有明显对比 -->
    app:popupTheme="@style/ThemeOverlay.MaterialComponents.Light"/>

2. 在MainActivity中把Toolbar设置为SupportActionBar：

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    setContentView(R.layout.activity_main)
    
    val toolbar = findViewById<MaterialToolbar>(R.id.toolbar)
    setSupportActionBar(toolbar)
}

3. （可选）在主题中统一配置Toolbar样式
   如果不想在布局里重复写样式，可以在自定义主题中全局配置：

<style name="Theme.Custom" parent="Theme.MaterialComponents.Light.NoActionBar">
    <!-- 全局配置Toolbar样式 -->
    <item name="toolbarStyle">@style/Widget.Custom.Toolbar</item>
    <!-- 你的其他自定义属性 -->
</style>

<style name="Widget.Custom.Toolbar" parent="Widget.MaterialComponents.Toolbar.Primary">
    <item name="titleTextColor">@color/white</item>
    <item name="background">?attr/colorPrimary</item>
</style>

快速验证小技巧 #

你可以先在Fragment里加一行日志，看看supportActionBar是不是null：

Log.d("ActionBarCheck", "supportActionBar is null? ${(activity as AppCompatActivity?)?.supportActionBar == null}")

如果打印true，说明根本没有ActionBar实例，直接用方案1或者方案2的步骤来创建；如果是false，那大概率是标题颜色和背景色撞色了，调整titleTextColor就能解决。

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