Android 隱藏標題欄的正確姿勢：requestWindowFeature vs Theme 方案深度解析

Android 開發中隱藏 Activity 標題欄是基礎需求，但許多開發者在使用 requestWindowFeature(Window.FEATURE_NO_TITLE) 或主題樣式時遭遇崩潰、閃屏或無效果。本文系統梳理兩種主流方案的適用場景、常見坑點與最佳實踐，助你一次搞定標題欄隱藏。

方案一：代碼動態隱藏 —— requestWindowFeature

核心規則（必須遵守）

1. 必須在 setContentView() 之前調用，否則拋出 AndroidRuntimeException: requestFeature() must be called before adding content。
2. 必須在 super.onCreate() 之後調用，否則窗口特性未初始化完成。

正確代碼範本

@Override
protected void onCreate(Bundle savedInstanceState) {
    super.onCreate(savedInstanceState);
    // 1. 請求無標題特性 —— 必須在 setContentView 之前
    requestWindowFeature(Window.FEATURE_NO_TITLE);
    // 2. 可選：全螢幕模式（隱藏狀態欄）
    // getWindow().setFlags(WindowManager.LayoutParams.FLAG_FULLSCREEN,
    //                      WindowManager.LayoutParams.FLAG_FULLSCREEN);
    // 3. 設置佈局
    setContentView(R.layout.activity_main);
    // 後續初始化...
}

適用場景

• 僅少數 Activity 需要隱藏標題欄
• 需根據運行時條件動態決定是否隱藏（如遊戲界面、視頻全屏播放）
• 不想修改全局主題樣式

方案二：主題樣式靜態隱藏（推薦用於全局/批量）

正確主題定義

<!-- res/values/styles.xml -->
<resources>
    <!-- 基礎主題：繼承 AppCompat -->
    <style name="AppBaseTheme" parent="Theme.AppCompat.Light.NoActionBar">
        <!-- 自定義屬性 -->
    </style>

    <!-- 應用主題 -->
    <style name="AppTheme" parent="AppBaseTheme">
    </style>
    
    <!-- 專用無標題主題（若基礎主題非 NoActionBar 變體） -->
    <style name="NoTitleTheme" parent="Theme.AppCompat.Light.NoActionBar">
        <item name="android:windowNoTitle">true</item>
        <item name="windowActionBar">false</item> <!-- 支援庫 ActionBar -->
        <item name="windowNoTitle">true</item> <!-- 標準窗口 -->
    </style>
</resources>

AndroidManifest.xml 應用

<application
    android:allowBackup="true"
    android:icon="@drawable/ic_launcher"
    android:label="@string/app_name"
    android:theme="@style/AppTheme" > <!-- 全局預設主題 -->

    <activity
        android:name=".MainActivity"
        android:label="@string/app_name"
        android:theme="@style/NoTitleTheme" /> <!-- 單獨 Activity 覆蓋 -->
        
</application>

常見崩潰原因與解決

進階：沉浸式狀態欄/導航欄（Android 4.4+）

若需隱藏標題欄並實現狀態欄透明/內容延伸至狀態欄區域：

<style name="TranslucentStatusTheme" parent="Theme.AppCompat.Light.NoActionBar">
    <!-- Android 4.4-4.3 -->
    <item name="android:windowTranslucentStatus">true</item>
    <item name="android:windowTranslucentNavigation">true</item>
    <!-- Android 5.0+ -->
    <item name="android:statusBarColor">@android:color/transparent</item>
    <item name="android:navigationBarColor">@android:color/transparent</item>
    <item name="android:windowDrawsSystemBarBackgrounds">true</item>
</style>

代碼中配合：

// 在 setContentView 後
if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.KITKAT) {
    Window window = getWindow();
    window.addFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
    // Android 5.0+ 可進一步設置
    if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.LOLLIPOP) {
        window.clearFlags(WindowManager.LayoutParams.FLAG_TRANSLUCENT_STATUS);
        window.getDecorView().setSystemUiVisibility(
            View.SYSTEM_UI_FLAG_LAYOUT_FULLSCREEN | View.SYSTEM_UI_FLAG_LAYOUT_STABLE);
        window.setStatusBarColor(Color.TRANSPARENT);
    }
}

方案選擇決策樹

1. 全應用/多數 Activity 無標題 → 方案二（主題），統一維護、無閃屏、效能最佳。
2. 少數特定 Activity 動態決定 → 方案一（代碼），靈活可控。
3. 需支援舊版 Android (≤ 3.0) 且不使用 AppCompat → 方案一配合 android:theme="@android:style/Theme.NoTitleBar"。
4. 使用 Toolbar 替代 ActionBar → 主題必須用 NoActionBar 變體，在佈局中自行放置 Toolbar。

總結

隱藏 Android 標題欄的核心在於主題繼承鏈正確與調用時機準確。現代 Android 開發（API 21+）強烈建議採用 Theme.AppCompat.Light.NoActionBar 系主題靜態配置，避免代碼動態調用帶來的時序問題與閃屏體驗。若遇到 IllegalStateException: You need to use a Theme.AppCompat theme，請優先檢查 styles.xml 中父主題是否為 Theme.AppCompat.* 子類，以及 AndroidManifest.xml 中 android:theme 屬性引用是否正確。