Android Studio 故障排查

本页面提供了针对 Android Studio 中常见问题和配置故障的排查指南。

高分辨率显示屏

从 1.5 版本开始，Android Studio 在所有平台上都提供了对高分辨率显示屏（如 HiDPI 和 Retina 显示器）的支持。

缩放比例设置

Android Studio 按如下方式确定显示屏的缩放比例：

Mac
对于 Retina 显示屏，界面 (UI) 元素会按 200% 的比例进行缩放，图像则以高分辨率呈现。即使在多显示器配置中，缩放也不会导致模糊。请注意，目前仅支持 100%（非 Retina 显示屏）和 200%（Retina 显示屏）这两种缩放比例，不支持其他比例。
Windows
Android Studio 使用主显示屏的 DPI 设置来确定界面元素的缩放比例。对于图像，如果缩放比例小于 150%，则会对普通分辨率的图像进行放大；如果缩放比例大于 150%，则会适当地缩放高分辨率图像。
Linux
Android Studio 通过查看“文本缩放比例”(Text Scaling Factor)，然后查看 XWindow 系统 DPI 设置来确定缩放比例。
96 的 DPI 设置对应 100% 的缩放比例（无缩放），192 的 DPI 设置对应 200% 的缩放比例（界面元素大小翻倍）。Android Studio 目前支持 96（100% 缩放）到 288（300% 缩放）之间的 DPI 设置。如果 Android Studio 未能在您的 Linux 或 Windows 机器上检测到正确的系统 DPI，您可以按照 自定义 IDE 属性 中的说明，通过在 idea.properties 文件中设置 hidpi 属性来手动进行设置。注意，此属性对 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，参见错误 192316）。从 2.2 版本开始，Android Studio 包含了一个捆绑的最新受支持 JDK 版本，其中已包含 JRE。要解决此问题，请将 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 的 gradle.properties 文件中添加系统属性 -Djava.net.preferIPv4Stack=true 来解决此问题，操作如下：

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

Windows 上更新 IDE 的问题

在 Windows 上，进程正在使用的文件无法被删除。当您尝试使用 IDE 内置的更新机制时，它有时会拒绝安装更新，通常会给出类似“Can't delete C:\some\path\file”的错误消息。

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

minSdkVersion 问题

如果您使用的是过时的 Android 支持库 (Support Libraries) 版本，可能会收到如下错误消息：

: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，RC 和 Canary 版为 AndroidStudioPreview。
  • VERSION 替换为版本号，例如：2023.1 或 2023.3。