1. 问题场景为什么你的Android Studio日志突然“天书”了如果你最近更新了Android Studio或者从同事那里拷贝了一个项目又或者只是切换了一下电脑然后突然发现运行应用时Logcat窗口里本该是清晰可读的日志变成了一堆问号、方块或者各种奇怪的符号比如?????或者用户名不能为空那么恭喜你你遇到了经典的“日志乱码”问题。这绝不是个例而是Android开发者尤其是Windows平台和部分Linux环境下开发者经常踩的一个坑。这个问题不解决调试效率直接归零因为你根本看不懂程序在“说”什么。简单来说乱码的本质是字符编码不匹配。你的应用程序或系统在输出日志时使用了一种编码比如UTF-8而Android Studio的Logcat在显示时却试图用另一种编码比如系统的默认编码GBK去解读这些字节流结果自然就对不上号显示为乱码。对于中文开发者这个问题尤为突出因为中文字符在UTF-8下通常由2-3个字节表示如果用单字节的ASCII或本地编码去读必然出错。在深入解决方案之前我们先明确两个最常见的乱码触发场景系统或IDE环境编码设置问题这是最常见的原因。你的操作系统如Windows默认使用GBK编码而Android应用和Gradle构建过程普遍默认使用UTF-8。当Logcat捕获来自系统或JVM的日志时如果IDE没有明确指定解码方式就会用系统默认编码去解析UTF-8的字节导致乱码。adbAndroid Debug Bridge传输编码问题Logcat的日志数据是通过adb从设备或模拟器传输到IDE的。如果adb在传输过程中或IDE在接收时没有统一字符集也可能产生乱码。这在跨平台协作如Windows主机连接Linux虚拟机中的设备时偶尔会出现。接下来我将从几个层面由浅入深地提供一套完整的排查和解决方案。这些方法我都亲自验证过你可以根据你的具体情况对号入座。2. 第一层排查Android Studio 内置设置修正大多数情况下问题出在Android Studio自身的Logcat配置上。这是我们应该首先检查的地方。2.1 修改Logcat控制台输出编码这是最直接、最常用且成功率最高的方法。Android Studio的Logcat视图可以独立配置其用于解码日志流的字符集。操作步骤打开Android Studio确保Logcat窗口是可见的通常在IDE底部。在Logcat窗口的工具栏上找到并点击齿轮图标设置。在下拉菜单中选择“Configure Logcat Format…”或类似选项不同版本可能略有差异也可能是直接在Logcat窗口右键选择“Configure”。在弹出的配置对话框中你会看到一系列选项。关键点在于找到“编码”或“Charset”相关的设置项。将其从默认的可能是系统编码或Default修改为UTF-8。点击确定或应用然后重启Android Studio。是的重启很重要让配置完全生效。注意有些较新版本的Android Studio如Flamingo | 2022.2.1 之后将这个设置整合到了更全局的地方。如果上述路径找不到可以尝试File - Settings - Editor - General - Console 然后检查“Default Encoding”是否设置为UTF-8。同时确保“Use console output encoding instead of ‘Default Encoding’”这个选项不要勾选如果勾选了它会覆盖你的设置。为什么是UTF-8因为现代软件开发尤其是跨平台和网络应用UTF-8已经成为事实上的标准。Java虚拟机JVM、Android SDK、Gradle以及绝大多数开源库在输出文本时都默认或优先使用UTF-8。将Logcat的解码器也设置为UTF-8就实现了“输出”和“显示”的编码统一。2.2 检查项目与IDE的全局文件编码确保整个工作环境都使用UTF-8可以避免很多潜在冲突。项目文件编码打开File - Settings - Editor - File Encodings。确认以下三项全部设置为UTF-8Global EncodingProject EncodingDefault encoding for properties files同时观察下方的“Transparent native-to-ascii conversion”选项对于.properties资源文件这个选项通常建议勾选它能自动处理Unicode转义序列如\u4e2d\u6587但这不是乱码的主因保持默认即可。Gradle构建脚本编码虽然Gradle本身使用UTF-8但我们可以显式地在项目的gradle.properties文件中如果没有请在项目根目录创建添加一行强制指定org.gradle.jvmargs-Dfile.encodingUTF-8这行参数会传递给所有Gradle守护进程的JVM确保其在读写文件、处理控制台输出时都使用UTF-8编码。完成上述设置后执行一次Build - Clean Project然后Rebuild Project再运行应用查看Logcat。3. 第二层排查操作系统与JVM环境变量如果修改了Android Studio所有设置后问题依旧那么问题可能源于更底层的运行环境——即启动Android Studio的JVM或操作系统本身的环境变量。3.1 修改Android Studio启动脚本的JVM参数我们需要告诉运行Android Studio本身的Java虚拟机使用UTF-8编码。操作步骤Windows与macOS/Linux路径不同Windows:找到Android Studio的安装目录进入bin文件夹。使用文本编辑器如Notepad不要用Windows自带的记事本打开studio64.exe.vmoptions文件如果你用的是64位版本。32位则打开studio.exe.vmoptions。在文件的末尾添加一行-Dfile.encodingUTF-8保存文件完全关闭并重启Android Studio。macOS / Linux:找到Android Studio的启动脚本。通常从应用程序启动时可以在启动后通过“Help - Edit Custom VM Options…”菜单直接打开配置文件。如果没有配置文件通常位于~/Library/Application Support/Google/AndroidStudio[版本号]/studio.vmoptions(macOS) 或~/.config/Google/AndroidStudio[版本号]/studio.vmoptions(Linux)。同样在文件末尾添加-Dfile.encodingUTF-8。保存并重启Android Studio。原理说明-Dfile.encodingUTF-8是一个JVM系统属性它设置了JVM默认的字符编码。Android Studio本身是一个Java Swing应用它的控制台、文件读写等操作都受此参数影响。设置后能保证IDE内部处理的文本编码一致性。3.2 检查系统环境变量Windows重点在Windows上系统的默认编码通过chcp命令查看通常是GBK代码页936会严重影响命令行程序的行为。虽然Android Studio是GUI应用但它的构建进程Gradle Daemon和adb都可能继承或受系统环境变量影响。临时设置用于测试打开命令提示符CMD或PowerShell。在启动Android Studio之前先执行命令chcp 65001。这个命令将当前控制台的代码页设置为UTF-865001对应UTF-8。然后不要关闭这个命令行窗口从这个命令行窗口中启动Android Studio找到studio64.exe的路径并执行。这样Android Studio及其子进程就会在一个UTF-8编码环境的命令行上下文中启动。测试日志是否正常。如果正常说明问题确实与系统编码环境有关。创建快捷方式半永久方案如果上述方法有效你可以创建一个批处理文件.bat来启动Android Studio。新建一个文本文件写入echo off chcp 65001 nul start C:\你的AndroidStudio安装路径\bin\studio64.exe将文件保存为StartAS-UTF8.bat以后都通过这个批处理文件启动Android Studio。踩坑记录chcp 65001在Windows传统控制台ConHost中对某些字体支持可能有问题可能导致部分字符显示为问号但这通常不影响Logcat内部的文本渲染。如果遇到这种情况可以尝试更换控制台字体为“NSimSun”或“Consolas”。更根本的解决方案是下面这个。3.3 设置系统级环境变量推荐一劳永逸对于Windows 10/11我们可以设置一个用户或系统级别的环境变量来影响所有Java/Gradle进程。右键点击“此电脑” - “属性” - “高级系统设置” - “环境变量”。在“用户变量”或“系统变量”区域点击“新建”。变量名输入JAVA_TOOL_OPTIONS变量值输入-Dfile.encodingUTF-8点击确定保存所有窗口。这个变量的魔力在于任何在此之后启动的JVMJava虚拟机都会自动读取这个环境变量并将其中的参数这里是-Dfile.encodingUTF-8附加到自己的启动命令中。这意味着不仅Android Studio连Gradle守护进程、通过命令行运行的java或javac命令都会默认使用UTF-8编码。设置完成后重启电脑至少重启所有已打开的Android Studio和命令行窗口让环境变量生效。这是我认为解决Windows下中文乱码最彻底的方法之一。4. 第三层排查adb与模拟器/设备端当前面所有IDE和系统层面的设置都无效时我们需要将目光投向日志的源头——Android设备或模拟器以及传输工具adb。4.1 检查或修改adb服务器启动参数adb服务器是在你第一次执行adb命令时在后台启动的。我们可以尝试指定adb的字符集。首先确保所有Android Studio实例和模拟器都已关闭。打开命令提示符或终端依次执行以下命令来杀死已有的adb服务器并指定编码重启adb kill-server set ADB_TRACEall # Windows设置临时环境变量仅用于调试非必需 adb devices -a # 这会启动新的adb服务器但可能不继承编码设置更直接的方法是在启动adb server时尝试传递参数但标准的adb命令并不直接支持编码参数。一种间接的方法是像设置Android Studio一样确保启动adb的那个命令行环境本身编码是UTF-8即先执行chcp 65001。模拟器特定设置如果你使用的是Android模拟器可以尝试在模拟器的启动命令中或AVD管理器中为其附加JVM参数。编辑你的虚拟设备AVD在“高级设置”中找到“模拟器命令行选项”添加-prop persist.sys.languagezh -prop persist.sys.countryCN虽然这主要是设置语言区域但有时也能间接影响日志编码。不过这不是主要手段。4.2 极端情况设备系统区域设置极少数情况下设备本身的系统区域或语言设置可能会影响某些系统日志的格式虽然应用自身的Log.d等输出应不受影响。确保你的测试设备或模拟器的语言和区域设置为中文中国。这通常在设备的“设置”-“系统和更新”-“语言和输入法”中完成。5. 问题诊断与高级技巧当标准方法失效时你需要化身侦探进行更精细的诊断。5.1 使用纯命令行adb logcat进行隔离测试这是判断问题出在IDE还是底层adb传输的关键一步。关闭Android Studio。打开一个已经执行过chcp 65001的命令行窗口Windows或终端macOS/Linux。连接你的设备或启动模拟器。执行命令adb logcat -v time -s MyAppTag:D-v time让日志包含时间戳便于阅读。-s MyAppTag:D过滤只显示标签为“MyAppTag”且级别为Debug及以上的日志。请将MyAppTag替换成你应用里使用的日志标签例如MainActivity。在设备上操作你的应用观察命令行窗口输出的日志。如果命令行输出是正常的那么恭喜问题范围缩小了。乱码是Android Studio的Logcat视图渲染问题与adb传输和设备无关。请回头仔细检查本文第2节Android Studio设置特别是Logcat的“Configure Logcat Format…”中的编码设置并确认没有其他插件干扰。如果命令行输出也是乱码那问题就出在更底层可能是系统环境变量JAVA_TOOL_OPTIONS没生效、设备系统区域、或者应用代码本身输出就有问题比如用错误的编码将字节数组转成了字符串。此时应重点排查第3.3节的系统环境变量并确保你的应用代码没有硬编码非UTF-8的编码操作。5.2 代码层面输出编码检查在你的应用代码中确保所有字符串操作都明确使用UTF-8尤其是在处理网络数据、文件读写或字节数组转换时。虽然Log.d(String, String)方法本身不涉及编码转换但如果你打印的内容来自于一个字节数组就需要小心。错误示例val byteArray ... // 来自网络或文件编码是UTF-8 val message String(byteArray) // 默认使用平台编码在Windows上是GBK导致乱码 Log.d(NETWORK, message)正确做法val byteArray ... val message String(byteArray, Charsets.UTF_8) // 明确指定UTF-8解码 Log.d(NETWORK, message)5.3 处理第三方库或框架的日志乱码有时乱码只出现在某个特定库如OkHttp、Retrofit、某些Native库的日志中。这通常是因为该库在记录日志时使用了其自身的日志系统并且可能没有正确设置编码。解决方案查阅该库的文档看是否有设置日志编码或区域Locale的配置项。例如对于使用java.util.logging的库你可以尝试在应用初始化时设置系统属性System.setProperty(sun.stdout.encoding, UTF-8); System.setProperty(sun.stderr.encoding, UTF-8);但请注意这并非对所有库都有效且可能带来其他副作用。6. 总结与终极核对清单面对Android Studio日志乱码不要慌张按照以下清单自上而下系统性地排查99%的问题都能解决第一站Android Studio Logcat视图设置[ ] 打开Logcat设置将编码明确改为UTF-8。[ ] 检查File - Settings - Editor - General - Console 确保默认编码为UTF-8并取消“Use console output encoding”的勾选如果存在。[ ] 重启Android Studio。第二站项目与IDE全局编码[ ] 检查File - Settings - Editor - File Encodings 确保全局、项目、属性文件编码均为UTF-8。[ ] 在项目根目录的gradle.properties中添加org.gradle.jvmargs-Dfile.encodingUTF-8。[ ] 执行一次Clean Rebuild。第三站JVM与系统环境Windows用户重点[ ] 修改Android Studio的VM选项文件studio64.exe.vmoptions添加-Dfile.encodingUTF-8。[ ]强烈推荐添加系统/用户环境变量JAVA_TOOL_OPTIONS值为-Dfile.encodingUTF-8。[ ]重启电脑确保所有更改生效。第四站隔离测试与深度诊断[ ] 在设置为UTF-8编码chcp 65001的命令行中使用adb logcat直接查看日志判断问题范围。[ ] 检查应用代码中是否存在未指定编码的字节到字符串转换。[ ] 如果是第三方库日志乱码查阅其文档寻找编码配置。我个人在多年的开发和团队协作中发现环境变量JAVA_TOOL_OPTIONS-Dfile.encodingUTF-8配合 Android Studio Logcat 编码设置为 UTF-8这套组合拳几乎能根除所有Windows平台下的中文日志乱码问题。对于macOS和Linux通常只需做好第一、二步即可。记住编码问题贵在统一确保从源码、到编译、到运行、到显示整个链条都使用同一种编码UTF-8就能彻底告别乱码的困扰。