Android Studio 新手常見問題：AndroidManifest.xml 包名與 Activity 路徑不匹配

問題現象

Android Studio 專案結構截圖顯示紅色報錯，提示找不到 Activity 類或包名不匹配。

核心原因

AndroidManifest.xml 中聲明的包名與實際 Java/Kotlin 類所在包路徑不一致。

典型錯誤場景

<!-- AndroidManifest.xml -->
<manifest package="com.example.myapp" ...>
    <activity android:name=".MainActivity" />  <!-- 相對路徑：com.example.myapp.MainActivity -->
</manifest>

但實際文件結構為：

src/
└── main/
    └── java/
        └── com/
            └── other/
                └── package/      <-- 實際包路徑
                    └── MainActivity.java  <-- package com.other.package;

解決方案

方案一：修正 Manifest 包名（推薦）

<manifest package="com.other.package" ...>  <-- 改為實際包名
    <activity android:name=".MainActivity" />
</manifest>

方案二：使用全路徑類名

<activity android:name="com.other.package.MainActivity" />  <-- 絕對路徑
<!-- manifest package 保持不變 -->

方案三：重構包結構（最徹底）

1. 右鍵包名 → Refactor → Rename
2. 將包重命名為 Manifest 中聲明的包名
3. AS 自動更新所有 import 和引用

驗證檢查清單

• [ ] `manifest` 標簽的 `package` 屬性 = 基礎包名
• [ ] `activity` 的 `android:name`：
  • 以 `.` 開頭 → 相對於 `package`
  • 含 `.` 且不以 `.` 開頭 → 完整類名
• [ ] 實際 `.java/.kt` 文件的 `package` 聲明與路徑一致
• [ ] `build.gradle` 中 `applicationId` 與 `manifest package` 一致（通常同步）

常見陷阱

最佳實踐

1. 創建專案時確定包名，後續**避免手動修改** `manifest package`
2. 使用 AS 重構工具移動/重命名包，保證同步
3. 新建 Activity 時勾選「Generate manifest entry」自動註冊
4. 定期執行 `Build → Clean Project` 同步索引

本質是**聲明與實際不符**，修正二者一致即可消除紅色報錯。