排查 Android Studio 问题

本页包含有关排查 Android Studio 中的常见问题和配置问题的指南。

高密度显示屏

从版本 1.5 开始,Android Studio 在所有平台上提供了对高密度显示屏(如 HiDPI 和 Retina 显示器)的支持。

缩放比例设置

Android Studio 根据如下原则确定显示屏的缩放比例:

Mac
对于 Retina 显示屏,界面元素按 200% 的比例缩放,而图像则以高分辨率呈现。不应因为缩放而导致模糊,即使在多显示器配置中也不例外。请注意,暂不支持 100%(对于非 Retina 显示屏)和 200%(对于 Retina 显示屏)之外的其他缩放比例。
Windows
Android Studio 使用主显示屏的 DPI 设置来确定界面元素的缩放比例。对于图像,如果缩放比例小于 150%,则会放大正常分辨率的图像。如果缩放比例大于 150%,则会相应缩放高分辨率图像。
Linux
Android Studio 通过先查看“文本缩放比例”再查看 XWindow 系统 DPI 设置来确定缩放比例。
DPI 设置为 96 对应于缩放比例为 100%(无缩放),DPI 设置为 192 对应于缩放比例为 200%(界面元素的尺寸放大一倍)。Android Studio 当前支持介于 96(100% 缩放)和 288(300% 缩放)之间的 DPI 设置。如果 Android Studio 在您的 Linux 或 Windows 计算机上未检测到正确的系统 DPI,您可按照自定义 IDE 属性中的说明在 idea.properties 文件中设置 hidpi 属性来手动设置 DPI。请注意,此属性在 Mac 计算机上不起作用。此属性的工作方式如下:
hidpi=true
将 DPI 设置为 192(200% 缩放),忽略系统设置。
hidpi=false
将 DPI 设为 96(100% 缩放),忽略系统设置。

在高密度显示屏上元素显示模糊或像素化

如果 Android Studio 的界面中有一个或多个元素在您的高密度显示屏上显示模糊或像素化,您可能遇到了以下某个问题:

  • 如果 Android Studio 界面中的大多数元素显示正常,但有一个特定的图标显示模糊或像素化,或者某个特定的界面元素使用了大小错误的字体,则说明该特定元素很可能尚未完全进行针对 HiDPI 支持的更新。请依次点击 Help > Submit Feedback,提交错误报告。请在报告中包含屏幕截图以及尽可能详尽的系统配置相关信息。
  • 如果您使用的是 Windows 或 Linux 计算机,而您的显示屏使用 100% 或 200% 之外的缩放比例,则图像可能会因缩放而出现轻微模糊。
  • 如果您使用的是 Windows 计算机,并且您已在控制面板中更改 Windows 的字体大小,您可能会遇到字体模糊或像素化的问题。您可以通过注销 Windows 然后重新登录来解决此问题。
  • 在运行 Windows 8.1 或更高版本的多显示器设置中,当您将一个窗口从一台显示器移至另一台分辨率或 DPI 不同的显示器时,您可能会遇到字体或图像方面的问题(请参阅错误 186007)。此问题尚无已知的解决方法。
  • 较低版本的 JRE 1.8 中存在字体模糊的问题(特别是 JRE 1.8.0_25-b18 amd64,请参阅 bug 192316)。从版本 2.2 开始,Android Studio 捆绑了所支持的最新版 JDK,其中包含此 JDE。如要解决此问题,请将 Android Studio 更新至版本 2.2 或更高版本,然后通过依次点击 File > Project Structure > SDK Location 并勾选 Use embedded JDK 复选框,改为使用所捆绑的 JDK。

高密度显示屏上显示的元素大小不正确

如果在您的高密度显示屏上,整个 Android Studio 界面的大小不正确,请参阅缩放比例设置。如果在您的高密度显示屏上,Android Studio 界面的部分元素大小不正确,但其他元素大小正确,那么您可能遇到了以下某个问题:

  • 如果您使用的是自定义编辑器方案,那么在高密度显示屏上,与其他界面元素相比,此编辑器的字体可能看上去太小或太大。如要修复此问题,请依次点击 File > Settings,然后依次点击 Editor > Colors and Fonts > Font,更改编辑器的字体大小。请注意,当启用默认方案时,将会自动缩放编辑器的字体大小(请参阅错误 186920)。
  • 如果 Android Studio 的某些界面元素的大小合适,但其他元素太小或太大,那么您可能遇到了问题 186923。请依次点击 Help > Submit Feedback,提交错误报告。请在报告中包含屏幕截图以及尽可能详尽的系统配置相关信息。

项目同步问题

尝试同步您的项目时,您可能会收到以下错误消息:“Connection to the Internet denied. ('Permission denied: connect')”。您可以通过在 Android Studio 中将系统属性 -Djava.net.preferIPv4Stack=true 添加到 gradle.properties 文件,使系统不再显示此错误消息,具体操作步骤如下:

  1. 在 Android Studio 中打开 gradle.properties 文件。
  2. 将以下代码行添加到该文件中:
    org.gradle.jvmargs=-Djava.net.preferIPv4Stack=true
    
    请注意,如果您已将其他 Gradle JVM 参数添加到 gradle.properties 文件中,可以将此属性添加到同一行,如以下示例所示:
    org.gradle.jvmargs=-Xmx2048m -XX:MaxPermSize=512m -Djava.net.preferIPv4Stack=true
    
  3. 重启 Android Studio,以使您所做的更改生效。
  4. 点击 Sync Project with Gradle Files 图标 以同步您的项目。

在 Windows 上更新 IDE 时出现问题

在 Windows 上,无法删除进程正在使用的文件。当您试图使用 IDE 内置的更新机制执行更新时,有时,系统会拒绝安装更新,通常还会提供类似“无法删除 C:\some\path\file”这样的错误消息。

如要解决此问题,请打开任务管理器并尝试终止可能正在使用该文件的进程,如任何 Gradle 守护程序。

minSdkVersion 问题

如果您使用的是过时的 Android 支持库版本,您可能会收到下面这样的错误消息:

:app:processDebugManifest app/src/main/AndroidManifest.xml:0:0 Error:
uses-sdk:minSdkVersion 19 cannot be smaller than version L declared in library app/build/intermediates/exploded-aar/com.android.support/appcompat-v7/21.0.0-rc1/AndroidManifest.xml
Suggestion: use tools:overrideLibrary="android.support.v7.appcompat" to force usage

如要解决此问题,请使用 SDK 管理器更新至最新版(非预览版)Android 支持库。如需详细了解如何设置支持库,请参阅支持库设置

Android 模拟器问题

请参阅 Android 模拟器问题排查

目录

Android Studio 使用以下目录来存储设置、缓存、插件和日志。

Windows

  • 配置 (idea.config.path):%APPDATA%\Google\AndroidStudioVERSION
  • 插件 (idea.plugins.path):%APPDATA%\Google\AndroidStudioVERSION\plugins
  • 系统 (idea.system.path):%LOCALAPPDATA%\Google\AndroidStudioVERSION
  • 日志 (idea.log.path):%LOCALAPPDATA%\Google\AndroidStudioVERSION\log
  • %APPDATA% 示例:C:\Users\YourUserName\AppData\Roaming
  • %LOCALAPPDATA% 示例:C:\Users\YourUserName\AppData\Local

macOS

  • 配置 (idea.config.path):~/Library/Application Support/Google/AndroidStudioVERSION
  • 插件 (idea.plugins.path):~/Library/Application Support/Google/AndroidStudioVERSION/plugins
  • 系统 (idea.system.path):~/Library/Caches/Google/AndroidStudioVERSION
  • 日志 (idea.log.path):~/Library/Logs/Google/AndroidStudioVERSION

Linux

  • 配置 (idea.config.path):~/.config/Google/AndroidStudioVERSION
  • 插件 (idea.plugins.path):~/.local/share/Google/AndroidStudioVERSION
  • 系统 (idea.system.path):~/.cache/Google/AndroidStudioVERSION
  • 日志 (idea.log.path):~/.cache/Google/AndroidStudioVERSION/log

系统会按以下格式列出每个目录:

替换:

  • AndroidStudio 替换为产品名称,如果是稳定版,则为 AndroidStudio;如果是 Beta 版和 Canary 版,则为 AndroidStudioPreview
  • VERSION 替换为版本。例如:2023.12023.3