Android Studio 專案路徑含中文導致編譯錯誤的解決方案

問題現象

將 Android 1.0 專案導入 Android Studio 1.5 後執行報錯，錯誤截圖顯示路徑中包含中文字元。

根本原因

Gradle 與 Android 建構工具不支援路徑中的非 ASCII 字元（包含中文、全形符號、空格等）。 當專案路徑、使用者目錄或 SDK 路徑含有中文時，會導致 aapt、dx 等工具無法正確解析路徑，進而拋出「unsupported major.minor version」或「file not found」等誤導性錯誤。

解決步驟

1. 移動專案：將專案資料夾移至純英文路徑，例如 D:\Projects\MyApp。
2. 檢查 SDK 路徑：在 File > Settings > Appearance & Behavior > System Settings > Android SDK 確認 SDK Location 無中文。
3. Gradle 快取清理：刪除專案下的 .gradle、build 資料夾，再次 Build > Clean Project。
4. Invalidate Caches：File > Invalidate Caches / Restart > Invalidate and Restart。

避坑指南

• ✅ 專案路徑、使用者名稱、SDK 路徑全部使用英文/數字/底線
• ✅ 避免在「桌面」、「文件」等中文預設資料夾下建立專案
• ✅ 團隊協作時，在 .gitignore 加入 local.properties 避免提交機器專屬路徑

快速驗證

在終端機執行：

cd 你的專案路徑
gradlew clean assembleDebug

若無紅字報錯，即表示路徑問題已解決。