Android Studio 導入項目中文註解亂碼終極解決方案

現象

導入舊項目或打開文件時，中文註解顯示為亂碼（如 涓婁笅），編輯區、Logcat 同樣受影響。

根因

文件實際編碼（GBK/GB2312）與 IDE 預期編碼（UTF-8）不一致。

分級解決方案

級別 1：修改 IDE 全局編碼（治標）

File → Settings → Editor → File Encodings
☑ Global Encoding: UTF-8
☑ Project Encoding: UTF-8
☑ Default encoding for properties files: UTF-8
☑ Transparent native-to-ascii conversion

級別 2：批量轉換文件編碼（治本，推薦）

1. 安裝插件 Encoding 或 File Encoding Converter。
2. 右鍵項目/目錄 → Convert to UTF-8 (或 GBK→UTF-8)。
3. 或命令行批量轉換：

# Linux/Mac/Git Bash
find . -name "*.java" -exec iconv -f GBK -t UTF-8 {} -o {}.utf8 \; -exec mv {}.utf8 {} \;

# Windows PowerShell
Get-ChildItem -Recurse -Filter *.java | ForEach-Object {
    $content = Get-Content $_.FullName -Encoding Default
    Set-Content $_.FullName -Value $content -Encoding UTF8
}

級別 3：Gradle 編譯任務強制編碼（防復發）

tasks.withType(JavaCompile) {
    options.encoding = 'UTF-8'
}

// Kotlin DSL
tasks.withType(org.gradle.api.tasks.compile.JavaCompile::class.java) {
    options.encoding = "UTF-8"
}

級別 4：文件頭聲明編碼（針對單文件）

// 在 Java 文件第一行添加
// -*- coding: UTF-8 -*-

驗證清單

• Editor 底部右側編碼顯示 UTF-8。
• 編譯無 unmappable character for encoding UTF-8 警告。
• Logcat 中文正常顯示。
• Git diff 無編碼變更噪音。

一次配置，永久告別亂碼。