如果你和我一样在 Ubuntu 上搭过安卓开发环境Android Studio应该会对几个反直觉的坑印象深刻教程让你先装 JDK装完才发现 AS 自带SDK 组件下载转圈半天模拟器起来以后卡成幻灯片。这篇就是把这些问题一次讲清从依赖准备、安装方式取舍、SDK 加速、KVM 模拟器到 Gradle 镜像给出一套照着做就能跑通的完整路径。不管你是刚接触 Linux 的安卓新手还是从 Windows/macOS 迁过来的老手甚至是在虚拟机里体验 Ubuntu 的环境这篇都能覆盖到。顺带会把 snap、apt、官网 tar.gz 三种安装方式的取舍以及无线调试、项目迁移这些高频场景一并讲完。1. 开始之前硬件评估、磁盘规划以及那个早已过时的 JDK 步骤1.1 三种常见环境下的硬件要求Ubuntu 上装 Android Studio本身对机器要求不算苛刻但安卓开发的完整链路IDE SDK 模拟器 Gradle会把资源吃得很凶。我整理了一个参考标准场景内存CPU磁盘空闲结论物理机安装 Ubuntu16GB 以上4 核及以上预留 30GB 以上最推荐模拟器也能流畅跑VMware/VirtualBox 虚拟机至少 8GB4 核预留 30GB能装能写代码但模拟器很难流畅WSL2 环境16GB 以上4 核预留 30GB适合轻量开发和真机调试实际使用中8GB 内存跑 AS 和模拟器会非常紧张操作系统加 IDE 加浏览器内存就见底了Gradle 构建时风扇转得像起飞。我自己在 16GB 物理机上开一个项目、一个模拟器、再加浏览器和终端内存占用一直在 10GB 附近徘徊。所以宁可内存大一点也别在配置上抠门。1.2 别再被旧教程忽悠JDK 不需要手动装这是我最想先讲清楚的一点。很多教程还会让你sudo apt install openjdk-8或者 openjdk-11/17然后配置 JAVA_HOME。实际上Android Studio 从很早的版本开始就内置了 JetBrains Runtime目录就在安装路径下的jbr文件夹里。你手动装的那份 JDK不仅派不上用场反而可能给 Gradle 和 AGP 的版本匹配惹麻烦。如果你已经装了也不用卸载只要别在环境变量里强行设置JAVA_HOME指向它就行。真正需要单独装 JDK 的场景是你同时要写纯 Java 后端项目并且希望在命令行里随手用java、javac那是另一码事与安卓开发无关。1.3 一条命令装齐系统依赖打开终端先把软件源刷新一下sudo apt update然后安装sudo apt install -y wget curl unzip qemu-kvm libvirt-daemon-system libvirt-clientsqemu-kvm和libvirt-*是给 Android Emulator 的硬件加速用的虽然现在还没装 AS但先装好可以省掉后面一次重启。如果你是 20.04 及更早的 Ubuntu可能还需要 32 位运行库sudo apt install -y libc6:i386 libncurses5:i386 libstdc6:i386 lib32z1Ubuntu 22.04 和 24.04 下这些包大多已经被移除或换名字了不用强求。1.4 磁盘规划别等塞满了才后悔安装包约 1.2GB解压出来 2.5GB 左右SDK 组件按需下载模拟器镜像动辄 1GB 起步Gradle 缓存随着项目增多会涨到 10GB 以上。如果你打算长期使用建议一上来就给 home 目录留出 30GB 以上。如果 home 所在分区空间吃紧而另一个分区还有余量可以提前把 Gradle 缓存软链过去mv ~/.gradle /data/gradle-cache ln -s /data/gradle-cache ~/.gradle做软链前记得先退出正在运行的 IDE 和 Gradle 守护进程否则可能会失败。这个小习惯我后来一直保留省过不少磁盘空间告急的尴尬。2. 安装方式选型三种常见方案对比以及为什么官网 tar.gz 最省心2.1 三种安装方式的真实对比网上关于在 Ubuntu 上安装 Android Studio 的方式主要就三种snap、apt 和官网 tar.gz。这里直接给结论长期使用选官网 tar.gz。安装方式命令/途径优点缺点推荐度Snapsudo snap install android-studio --classic一条命令搞定自动更新沙箱限制偶尔导致 SDK 路径、文件访问问题启动点名慢不推荐apt在软件中心搜或第三方 PPA方便版本滞后非官方维护依赖易冲突不推荐官网 tar.gz官网下载压缩包解压干净、路径可控、故障排查简单需要手动建桌面快捷方式推荐我最初就是因为省事装了 snap 版。结果是在访问/data下的 SDK 时碰到权限问题折腾半天才意识到是 snap 沙箱对非 home 目录做了隔离。虽然可以绕开但这类问题排查成本高而且永远不知道下次升级会不会再冒出来一个。最后我卸载 snap 版改用官网 tar.gz世界安静了。2.2 官网下载与解压的完整步骤打开 developer.android.com/studio 在 Linux 64-bit 那一栏点击下载 tar.gz 包。如果想全程命令行操作可以用复制到的直链配合 wget 下载wget -c https://dl.google.com/dl/android/studio/ide-zips/2024.2.2.11/android-studio-2024.2.2.11-linux.tar.gz直链会随版本更新而变化不要拿旧文章里的写死链接硬套。下载完成后解压到/optsudo mkdir -p /opt/android-studio sudo tar -xzf android-studio-*-linux.tar.gz -C /opt然后启动/opt/android-studio/bin/studio.sh有人喜欢解压到 home 目录这也没问题。我选/opt是因为它更像系统软件的常规位置权限边界清晰多人共用机器时不会互相污染。2.3 桌面快捷方式从 .desktop 文件开始每次从终端敲studio.sh确实不专业。创建桌面入口文件mkdir -p ~/.local/share/applications nano ~/.local/share/applications/android-studio.desktop写入以下内容[Desktop Entry] Version1.0 TypeApplication NameAndroid Studio CommentAndroid Studio IDE Exec/opt/android-studio/bin/studio.sh %F Icon/opt/android-studio/bin/studio.png Terminalfalse CategoriesDevelopment;IDE; StartupNotifytrue StartupWMClassjetbrains-android-studio保存后执行chmod x ~/.local/share/applications/android-studio.desktop之后在应用程序菜单里搜索 Android Studio 就能直接打开。这一步做完安装阶段才算彻底完成。3. 首次启动与 SDK 下载进度条卡住的解决办法3.1 首次向导的关键选择第一次启动 Android Studio会先问你是否导入旧配置。第一次装就选Dont import settings省得从旧版本带过来一堆没用的配置。然后是 SDK 组件目录选择默认是~/Android/Sdk。如果你 home 空间不算紧张用默认就行。我个人的习惯是单独建一个分区把 SDK 放到独立目录比如/data/android-sdk。好处是以后重装系统时home 目录可以保留SDK 也省得重新下载。AS 会记住你填的路径即使路径带中文或空格新版也能正常处理但建议还是保持纯英文路径少一些莫名其妙的兼容问题。在向导的组件选择界面里推荐只勾当前项目最常用的几项Android SDK Platform当前主流版本API 34/35 之类Android SDK Build-ToolsAndroid SDK Command-line Tools不要第一次就把所有版本的 SDK Platform 全都勾上。哪个老项目需要老版本 SDK等打开项目时 AS 会提示安装再单独装也不迟。第一遍贪多只会让下载战线拉长没必要。3.2 SDK 下载卡住给 SDK Manager 配国内镜像这一步是无数人的噩梦。SDK 组件下载进度条转半天最后报超时。原因是 SDK 的默认下载源在 Google 服务器网络环境不那么理想的时候下载就是一场持久战。解决思路是给 SDK Manager 配置国内公开镜像源操作如下打开 Settings → Appearance Behavior → System Settings → Android SDK → SDK Update Sites取消勾选默认的Android SDK Repository避免它抢在镜像源之前被访问添加自定义源Name: Tencent MirrorURL:https://mirrors.cloud.tencent.com/AndroidSDK/Name: Aliyun MirrorURL:https://mirrors.aliyun.com/android.googlesource.com/点 Apply、OK再重新进入 SDK Manager 安装组件这两个都是国内公开镜像不是野路子很多公司内部就是这么配的。配完之后下载速度基本是肉眼可见的提升。不同 AS 版本的设置入口可能略有差异但搜 SDK Update Sites 一定找得到。3.3 装完 SDK 后先别急着建项目SDK 组件装完后其实已经可以创建 Hello World 了但我建议先别急着写代码。如果打算用模拟器先去 Device Manager 把系统镜像下载好如果打算用真机先去把 USB 调试环境和 adb 配好。原因很简单模拟器系统镜像体积不小有的版本要 1GB 往上。如果建完项目再去下载第一次启动项目时你会发现所有事情都在排队体验极差。把环境一次性配齐后面就是顺水推舟。4. 模拟器能不能用先看 KVM 和镜像架构4.1 一条命令判断 KVM 是否可用创建第一个 Android 项目通常很顺利点几下 Next 就行。真正的坎在模拟器启动那一刻。如果 KVM 没就绪模拟器要么起不来要么起来后卡成 PPT。先检查 CPU 是否支持虚拟化egrep -c (vmx|svm) /proc/cpuinfo结果大于 0说明 CPU 虚拟化指令已开启。然后再看 KVM 设备是否存在ls -l /dev/kvm如果看到/dev/kvm恭喜硬件加速就绪。如果不存在分两种可能BIOS 里没开虚拟化进入 BIOS 找到 Intel VT-x 或 AMD-V 相关选项并开启你是在 VMware/VirtualBox 里装的 Ubuntu需要在虚拟机设置的虚拟化引擎里勾选嵌套虚拟化KVM 没起时启动模拟器经常会直接报类似 CPU acceleration status: KVM is not installed 之类的错误或者模拟器窗口迟迟不出现。这时候别急着重装 AS先回到终端把 KVM 问题解决掉。4.2 给 AVD 选对镜像模拟器才能顺利跑起来KVM 就绪后在 Device Manager 里点击 Create device选一个 Pixel 型号然后在 System Image 里选 API 级别合适的 x86_64 镜像。有一个很容易踩的坑在 x86 机器上选了 ARM 架构的镜像。虽然也能装但运行效率惨不忍睹启动都要好几分钟。开发调试优先选 x86_64 的系统镜像别选错。第一次启动 AVD 需要一点耐心冷启动一两分钟很正常之后会快很多。如果你用的是真机调试这一步完全可以跳过时间和磁盘空间都省了。4.3 虚拟机里的 Ubuntu别和 AVD 硬磕如果你是在 VMware 或 VirtualBox 里装的 Ubuntu我得泼一盆冷水在这类虚拟机里跑 Android Emulator体验通常非常糟糕。原因在于虚拟机本身就占用了一层 CPU 虚拟化模拟器再叠加一层效率几乎不可用。我在 VMware 里实测过模拟器启动奇慢进入系统后操作也明显迟滞。如果就是想体验一下虚拟机里的 Ubuntu 安卓开发强烈建议直接走 USB 真机调试把 AVD 这关绕过去。等以后有条件上物理机双系统再回来享受模拟器的便利也不迟。WSL2 的情况也类似。虽然 WSLg 能显示 GUI但 Android Emulator 对 KVM 的依赖很强WSL2 里开启嵌套虚拟化需要额外配置不是开箱即用。WSL 用户想省事同样优先考虑真机。5. Gradle 首次构建提速init.gradle 和 distributionUrl 的正确打开方式5.1 卡住的根源发行版和依赖都从国外拉新建项目后的第一次 Gradle Sync很多人会看到进度条在一个地方停很久。这不是 AS 卡死是它在从 Google 的源下载 Gradle 发行版和依赖库。光是 Gradle 发行版就 100MB 多加上 AGP 插件和 androidx 依赖累计几百 MB 甚至更多。网络环境不好时这个阶段等上半小时也不稀奇。这也是android studio importing gradle project 太慢这类问题长期存在的根本原因。解决方案本质上就一句话把下载源换成国内公开镜像。5.2 建一个全局 init.gradleGradle 支持全局初始化脚本放在~/.gradle/init.gradle里对所有项目生效。先创建并编辑这个文件nano ~/.gradle/init.gradle写入allprojects { repositories { maven { url https://maven.aliyun.com/repository/public } maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/gradle-plugin } mavenCentral() google() } }保存后回到 AS 重新 Sync。allprojects中的repositories配置会让所有模块的依赖优先从镜像仓库拉取找不到的再回退到官方源。这个文件写一次以后每个项目都受益是性价比最高的加速操作之一。如果项目本身在settings.gradle.kts里显式声明了仓库部分情况下项目内配置优先级更高但先写上这层兜底总能解决大多数问题。5.3 distributionUrl 也换一下如果进度条卡在 Downloading gradle-x.x.x.zip说明 Gradle 发行版本身下载太慢。打开项目的gradle/wrapper/gradle-wrapper.properties找到distributionUrl改成腾讯云镜像distributionUrlhttps\://mirrors.cloud.tencent.com/gradle/gradle-8.10.2-bin.zip注意版本号必须和你原来的一致不要看到 8.10.2 就照抄。如果版本号不匹配下载可能失败而且报错信息往往不友好容易带人绕弯路。5.4 打开老项目时的版本匹配问题从 GitHub 或同事那里拿到的老项目打开时经常报一些让人摸不着头脑的错。常见原因之一是 Gradle 版本和 AGPAndroid Gradle Plugin版本不匹配。这里给一个粗略的对照关系AGP 版本要求的最低 Gradle 版本AGP 8.xGradle 8.xAGP 7.xGradle 7.xAGP 4.xGradle 6.x我的建议是打开老项目时优先保持它原有的 Gradle 版本把它原封不动地 Sync 通过再考虑升级。很多一打开就报错的案例本质上是在迁移时顺手升级了 AGP却没有配套升级 Gradle或者反过来。项目能跑起来永远比用上新版本更重要。6. 把 IDE 调到顺手状态中文语言包、输入法和代码字体6.1 Android Studio 官方中文语言包很多新手一上来面对全英文界面会出现短暂的界面恐慌。其实 Android Studio 的汉化非常简单官方提供了一个中文语言包插件。操作路径Settings → Plugins → Marketplace → 搜索 Chinese (Simplified) Language Pack for Android Studio → Install → 重启 IDE。装完之后菜单、设置项都会变成中文。不过要清楚一点中文包只是降低界面门槛真正的报错日志、官方文档还是英文这两样东西的学习价值远高于界面文字。6.2 Ubuntu 中文输入法别和 IDE 输入较劲热搜词里ubuntu 中文输入法怎么设置是高频问题。在 Ubuntu 上如果只使用系统自带的 ibus 拼音日常打字没问题但在 JetBrains 系 IDE 里偶尔会出现候选框不跟光标或者无法唤起的情况。我自己换成 fcitx5 之后稳定很多。配置方法大致是这样安装 fcitx5 和中文输入插件sudo apt install -y fcitx5 fcitx5-chinese-addons打开系统设置 → 区域与语言 → 输入源添加汉语拼音把系统的输入法框架切换为 fcitx5。具体入口在系统设置的输入法相关页面有些版本需要先装fcitx5-config-qt才能打开配置界面如果想用搜狗输入法 Linux 版去搜狗官网下载 deb 包sudo apt install ./sogoupinyin_*.deb装完在 fcitx5 里添加搜狗条目即可改完输入法框架后建议重启系统一次让环境变量完全生效。输入不了中文这种问题虽然不影响编译但它会让你瞬间失去写注释的欲望属于值得提前管理好的体验问题。6.3 字体把代码渲染调成接近 macOS 的观感热搜词里提到 wsl ubuntu 写代码最推荐的字体接近 macos 的体验说明大家对代码字体的要求挺统一的。Ubuntu 默认字体在部分屏幕上确实不够细腻尤其是中英文混排时。Linux 上比较容易获得好观感的代码字体是 JetBrains Mono其次 Fira Code、Source Code Pro。安装sudo apt install -y fonts-jetbrains-mono然后在 AS 的 Settings → Editor → Font 里选择 JetBrains Mono字号 14 或 16行距调成 1.2 左右。这样日常写代码的观感已经很接近 macOS 那种圆润舒服的体验了。如果你在 WSLg 下觉得字体发虚可以再看看 fontconfig 层面的 hinting 设置但一般情况下换字体已经能解决 80% 的问题。7. 真机调试与旧项目迁移无线连接、版本匹配和环境变量急救7.1 无线连接真机调试以 Android 11 为例热搜词里无线连接调试 vivo 手机很有代表性。Android 11 及以上系统内置了无线调试能力不需要 USB 线也不需要额外工具。步骤如下手机和电脑连到同一个 Wi-Fi手机开发者选项里打开无线调试在使用配对码配对设备的弹窗中记下 IP 地址和配对端口电脑终端执行adb pair 192.168.1.100:37000按提示输入 6 位配对码 5. 配对成功后执行adb connect 192.168.1.100:37001注意这个端口是无线调试页面里显示的调试端口和刚才的配对端口不是同一个很容易搞混。下面的 IP 和端口以你手机显示为准不要照抄示例。 6. 手机弹窗允许调试授权之后 AS 的设备列表就会多出这台无线设备不同厂商的 ROMvivo、小米、OPPO 等在开发者选项上会加一些额外确认连接不稳定时把无线调试页面保持在手机前台可以排除很多变量。7.2 从 Windows/macOS 换到 Ubuntu 时的项目迁移如果你带着旧项目从 Windows 或 macOS 切到 Ubuntu最容易遇到下面几个问题gradlew没有执行权限在终端里先执行chmod x gradlew否则会报 Permission denied。 2.local.properties记录的是旧机器的 SDK 路径迁移后最好直接删掉让 AS 根据当前环境的 SDK 路径自动重建 3. 不要拷贝.idea和build目录这些是本地配置和构建产物拷贝过去只会带来无意义的路径错乱和冲突。正确做法是只需要源码、Gradle 配置、gradle wrapper 这些必要文件如果项目迁移后报错别一直在 AS 图形界面里干瞪眼直接打开终端跑./gradlew assembleDebug终端输出的完整日志比 GUI 里给的那点摘要信息有用得多。7.3 环境变量配错导致基础命令失效的急救包最后聊一个配置环境变量时的经典惨案想设ANDROID_HOME结果把 PATH 覆盖了重启终端后发现ls、sudo全都不认识报 command not found。别慌用完整路径打开编辑器修回来/usr/bin/nano ~/.bashrc改完保存执行source ~/.bashrc。如果当前会话连 nano 都没法用先用下面这条把 PATH 恢复到标准状态export PATH/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin正确设置环境变量的方式是在~/.bashrc末尾追加export ANDROID_HOME$HOME/Android/Sdk export PATH$PATH:$ANDROID_HOME/platform-tools:$ANDROID_HOME/emulator关键点在第二行的$PATH:这意味着在原有 PATH 上追加新路径而不是把原有的全局替换掉。这个问题看着小但几乎每个换 Linux 环境的人都会踩一次提前打好预防针能省不少事。我自己的日常就是 Ubuntu 物理机 真机 USB 调试 Gradle 镜像加速几个项目来回切基本不卡壳。装完这一套之后回头再看Android Studio 在 Ubuntu 上的安装难度其实不高真正的分水岭全在那几个隐藏关卡KVM 有没有开、SDK 组件能不能顺利拉下来、Gradle 构建能不能跑赢时间。把这些前置问题解决掉后续开发反而比在 Windows 上省心不少。最后再补一个小建议从官网下载大文件时用wget -c带断点续传慢一点也比断了重来强。希望这篇能帮你在 Ubuntu 上少走一晚弯路。
