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，您可以通过在 idea.properties 文件中设置 hidpi 属性来手动设置，如自定义 IDE 属性中所述。请注意，此属性对 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 的捆绑版本，其中包含 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')”（拒绝连接到互联网。（“权限被拒绝：连接”））。您可以通过将系统属性 -Djava.net.preferIPv4Stack=true 添加到 Android Studio 中的 gradle.properties 文件来解决此错误消息，具体操作如下：

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

Windows 上 IDE 更新问题

在 Windows 上，被某个进程占用的文件无法删除。当您尝试使用 IDE 内置的更新机制时，有时它会拒绝安装更新，通常会提供类似“Can't delete 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 模拟器问题排查。

配置 (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

每个目录都按以下格式列出：

<非正式目录名称> (<IDE 属性>): <默认路径>。

替换

AndroidStudio 为产品名称，稳定版为 AndroidStudio，Beta 版和 Canary 版为 AndroidStudioPreview。
VERSION 为版本号。例如: 2023.1 或 2023.3。

Android Studio 问题排查 使用收藏夹保持井然有序 根据您的偏好保存和分类内容。