Win11 安装 Android Studio 和 Flutter 完整教程（含官方下载+全程防坑指南）

伞伞悦读
0 阅读15分钟

本文全程基于 官方下载渠道，详细讲解 Win11 系统下 Android Studio 和 Flutter 的安装、配置流程，重点补充本次实操中遇到的所有“坑点”及解决方案，兼顾新手友好性和实用性，确保每一步都可落地，避免重复踩坑。

核心原则：所有软件、工具均从官方网站下载，拒绝第三方镜像包、破解版，避免因非官方文件导致的安装失败、版本冲突、安全风险；全程同步防坑提示，针对本次实操中遇到的 Gradle 超时、版本冲突、语法错误、安装权限等问题，逐一给出解决方案。

一、前置准备（必看，提前避坑）

1.1 系统环境要求（Win11 专属）

  • 系统版本：Win11 专业版/家庭版（64位，版本号 21H2 及以上，避免旧版本兼容问题）；
  • 硬件配置：内存 ≥8GB（推荐 16GB，否则 Gradle 构建会卡顿），磁盘剩余空间 ≥20GB（Android Studio + SDK + Flutter + Gradle 占用空间较大）；
  • 必备组件：提前开启 Win11 “开发者模式”（设置 → 隐私和安全性 → 开发者选项 → 开启开发者模式），否则后续真机调试会受限；
  • 网络要求：全程需要稳定网络（官方下载需联网，建议使用有线网络或稳定Wi-Fi，避免移动热点频繁断连），无需科学上网，教程已适配国内网络环境。

1.2 提前下载的官方工具（全程官方渠道，附下载地址）

所有工具均从官方网站下载，杜绝第三方渠道，避免植入广告、恶意软件或版本不匹配问题，以下是官方下载地址及注意事项：

工具名称官方下载地址下载注意事项
Android Studio（含SDK）developer.android.com/studio?hl=z…（官方中文站）下载 “Android Studio Hedgehog
Flutter SDKflutter.dev/docs/get-st…（Flutter 官方文档）下载 Stable 稳定版（推荐最新稳定版，如 3.19.0），选择 Windows 对应的 ZIP 压缩包，无需安装，解压即可使用
Gitgit-scm.com/download/wi…（Git 官方站）下载 64位 Windows 版本，安装时勾选“在Windows命令提示符下使用Git”，后续 Flutter 依赖 Git 进行版本管理
Gradle（备用，解决下载超时）services.gradle.org/distributio…（Gradle 官方仓库）提前下载与 Android Studio 匹配的 Gradle 版本（本次实操为 8.14 版本，下载 gradle-8.14-all.zip，备用，避免后续下载超时）

1.3 前置防坑提醒（重中之重）

  1. 所有软件安装/解压路径 不能包含中文、空格或特殊字符（如“D:\软件\Android Studio”“C:\Users\张三\Flutter”均错误，正确路径如“D:\AndroidStudio”“D:\Flutter”），否则会导致 Gradle 构建失败、Flutter 命令无法识别；
  2. 提前关闭电脑管家、杀毒软件（部分软件会拦截 Gradle 下载、SDK 安装，导致安装失败），安装完成后再重新开启；
  3. 不要随意修改配置文件（如 build.gradle.kts），本次实操中因修改配置导致语法错误、版本冲突，新手建议先保留默认配置，后续再按需优化；
  4. 真机调试前，提前在手机上开启“开发者选项”“USB 调试”，并允许“USB 安装应用”，避免安装时提示“用户拒绝权限”。

二、安装 Android Studio（官方步骤+防坑细节）

2.1 官方安装步骤（全程下一步，重点看防坑提示）

  1. 双击下载的 Android Studio 安装包（.exe），弹出安装向导，点击“Next”；
  2. 勾选“Android Studio”和“Android Virtual Device”（安卓模拟器，可选，若电脑配置较低可取消，后续用真机调试），点击“Next”；
  3. 选择安装路径（重点：路径无中文、无空格，如“D:\AndroidStudio”），点击“Next”；
  4. 创建开始菜单文件夹，默认即可，点击“Install”，开始安装（耗时 5-10 分钟，取决于电脑配置）；
  5. 安装完成后，勾选“Start Android Studio”，点击“Finish”，启动 Android Studio。

2.2 首次启动配置（核心防坑环节）

首次启动 Android Studio 会进行初始化配置，重点解决“SDK 下载慢、配置失败”问题，步骤如下：

  1. 首次启动会弹出“Import Android Studio Settings”，选择“Do not import settings”，点击“OK”；
  2. 弹出“Android Studio Setup Wizard”，点击“Next”，选择“Standard”（标准配置，适合新手），点击“Next”；
  3. 选择界面主题（默认 Light 或 Darcula，按需选择），点击“Next”；
  4. 进入“SDK Components Setup”，系统会自动推荐需要安装的 SDK 版本（如 Android 14 SDK），无需修改，点击“Next”；
  5. 弹出“License Agreement”，勾选“Accept”，点击“Next”；
  6. 选择 SDK 安装路径（建议与 Android Studio 同目录，如“D:\AndroidStudio\SDK”，路径无中文），点击“Next”；
  7. 开始下载 SDK 及相关组件（耗时 10-20 分钟，取决于网络速度），下载完成后点击“Finish”，完成 Android Studio 配置。

2.3 安装中的坑点及解决方案（本次实操踩坑汇总）

坑点1：SDK 下载缓慢、超时，提示“Connection timed out”

【原因】SDK 默认从谷歌海外服务器下载，国内网络访问受限，即使有网络也会卡顿、超时；

【解决方案】无需修改镜像（坚持官方渠道），耐心等待，若多次超时，可关闭 Android Studio，重新启动配置向导，重复下载步骤（官方会自动重试，多试2-3次即可成功）；若仍失败，可暂时切换手机热点（部分网络运营商对谷歌服务器访问限制较低）。

坑点2：安装完成后，启动 Android Studio 提示“JDK 未找到”

【原因】Android Studio 自带 JDK，但路径配置错误，或电脑中安装了其他版本 JDK，导致冲突；

【解决方案】无需额外安装 JDK，Android Studio 自带的 JDK 可直接使用，操作如下：

  • 打开 Android Studio，点击“File → Settings → Build, Execution, Deployment → Build Tools → Gradle”；
  • 在“Gradle JDK”下拉框中，选择“Embedded JDK”（Android Studio 自带的 JDK，路径会自动显示）；
  • 点击“Apply → OK”，重启 Android Studio 即可解决。

坑点3：安装路径包含中文，导致启动失败、SDK 无法识别

【原因】中文路径会导致 Android Studio 无法读取配置文件、SDK 组件，属于新手最常见坑点；

【解决方案】卸载当前 Android Studio，重新安装，确保安装路径、SDK 路径均无中文、无空格（如“D:\AndroidStudio”，而非“D:\安卓开发\Android Studio”）。

三、安装 Flutter SDK（官方步骤+防坑细节）

3.1 官方解压与环境变量配置（核心步骤）

  1. 将从官方下载的 Flutter SDK ZIP 压缩包，解压到 无中文、无空格 的路径（如“D:\Flutter”，解压后会生成“flutter”文件夹，里面包含 bin、packages 等子目录）；

  2. 配置环境变量（让电脑识别 Flutter 命令），步骤如下：

    • 右键点击“此电脑 → 属性 → 高级系统设置 → 环境变量”；
    • 在“用户变量”中，找到“Path”，点击“编辑 → 新建”，添加 Flutter 的 bin 目录路径（如“D:\Flutter\bin”）；
    • 点击“确定”保存，关闭所有环境变量窗口（环境变量配置后，需重启命令行工具才能生效）。

  3. 验证 Flutter 环境配置：

    • 打开“命令提示符”（CMD）或“PowerShell”，输入命令 flutter --version；
    • 若能正常显示 Flutter 版本号（如 Flutter 3.19.0），说明环境变量配置成功；若提示“flutter 不是内部或外部命令”，则重新检查环境变量路径是否正确，或重启命令行工具。

3.2 关联 Android Studio（让 Flutter 识别 Android 开发环境）

  1. 打开 Android Studio，点击“File → Settings → Plugins”；
  2. 在搜索框中输入“Flutter”，找到 Flutter 插件，点击“Install”（安装过程中会自动提示安装 Dart 插件，点击“OK”一起安装）；
  3. 安装完成后，点击“Restart IDE”，重启 Android Studio，插件生效；
  4. 重启后，打开“命令提示符”，输入命令 flutter doctor，检查 Flutter 与 Android 环境的关联情况；
  5. 若输出中显示“Android Studio: ✅”“Android SDK: ✅”，说明关联成功；若有红色“×”，按照提示修复（通常是 SDK 路径未识别，需手动指定）。

3.3 安装中的坑点及解决方案（本次实操踩坑汇总）

坑点1：Flutter 环境变量配置后，提示“flutter 不是内部或外部命令”

【原因】环境变量路径配置错误，或未重启命令行工具，导致系统无法识别 Flutter 命令；

【解决方案】

  • 重新检查环境变量“Path”中添加的路径，确保是 Flutter 的 bin 目录（如“D:\Flutter\bin”，而非“D:\Flutter”）；
  • 关闭所有已打开的 CMD、PowerShell，重新打开，再次输入 flutter --version，即可正常识别。

坑点2：flutter doctor 提示“Android SDK location not found”

【原因】Flutter 未识别到 Android SDK 的安装路径，导致无法关联 Android 开发环境；

【解决方案】手动指定 SDK 路径，步骤如下：

  • 打开命令提示符，输入命令flutter config --android-sdk 你的SDK路径（如“flutter config --android-sdk D:\AndroidStudio\SDK”）；
  • 输入完成后，再次输入 flutter doctor，即可识别到 SDK，红色“×”会变为绿色“✅”。

坑点3：解压 Flutter SDK 时，提示“压缩包损坏”

【原因】官方下载过程中网络中断，导致压缩包不完整；

【解决方案】重新从 Flutter 官方下载 ZIP 压缩包，下载时建议使用浏览器自带的下载工具，避免使用第三方下载器，确保下载完成后压缩包大小与官方提示一致。

四、创建 Flutter 项目并运行（真机调试+全程防坑）

4.1 创建 Flutter 项目（官方步骤，避免配置错误）

  1. 打开 Android Studio，点击“Start a new Flutter project”；

  2. 选择“Flutter Application”，点击“Next”；

  3. 填写项目信息：

    • Project name：项目名称（如“flutter_demo”，只能包含英文、数字、下划线，不能有中文、空格）；
    • Flutter SDK path：选择 Flutter SDK 的解压路径（如“D:\Flutter”）；
    • Save location：项目保存路径（无中文、无空格，如“D:\FlutterProjects\flutter_demo”）；
    • Package name：包名（默认即可，后续发布 App 时可修改）；

  4. 点击“Next”，选择“Finish”，开始创建项目（首次创建会下载 Flutter 依赖，耗时 5-10 分钟，取决于网络速度）。

4.2 真机调试配置（重点，本次实操踩坑重点环节）

  1. 手机连接电脑：使用原装 USB 数据线（避免非原装数据线导致无法识别），连接手机与电脑；

  2. 开启手机开发者选项：

    • 安卓手机：设置 → 关于手机 → 连续点击“版本号”7次，开启开发者模式；
    • 返回设置 → 系统 → 开发者选项，开启“USB 调试”“USB 安装”（重点，否则安装时会提示权限拒绝）；
    • 连接电脑后，手机会弹出“允许 USB 调试吗？”，勾选“始终允许”，点击“确定”。

  3. Android Studio 识别手机：

    • 打开 Android Studio，顶部工具栏中，点击“Device”下拉框，会自动识别连接的手机（如本次实操的 vivo V2408A）；
    • 若未识别到，重新插拔 USB 数据线，或重启手机、Android Studio，再次尝试。

4.3 运行项目（核心环节，坑点最多，重点防坑）

  1. 在 Android Studio 中，点击顶部工具栏的“运行”按钮（▶️），开始构建项目（首次构建会下载 Gradle 依赖，耗时较长）；
  2. 构建完成后，手机会弹出“安装应用”弹窗，点击“安装”（不要拒绝，否则会提示安装失败）；
  3. 安装完成后，App 会自动启动，手机屏幕上会显示 Flutter 默认的计数器界面，说明运行成功。

4.4 运行中的坑点及解决方案（本次实操踩坑汇总，重中之重）

坑点1：Running Gradle task 'assembleDebug'... 卡住，提示“Connection timed out”（Gradle 下载超时）

【原因】首次运行项目时，Gradle 会自动下载对应版本（本次为 8.14 版本），默认从海外服务器下载，国内网络超时，这是本次实操中最耗时的坑点；

【解决方案】使用官方下载的 Gradle 包，手动放入缓存目录，彻底绕开网络下载（全程官方文件，无第三方镜像），步骤如下：

  1. 找到 Gradle 缓存目录：Win11 路径为 C:\Users\你的用户名.gradle\wrapper\dists\gradle-8.14-all（“你的用户名”替换为自己电脑的用户名）；
  2. 打开该目录，会看到一个随机字符的子文件夹（如“c2qonpi39x1mddn7hk5gh9iqj”），进入该文件夹；
  3. 删除文件夹内的所有临时文件（如 gradle-8.14-all.zip.lck、gradle-8.14-all.zip.part，这些是下载中断的临时文件，会干扰识别）；
  4. 将提前从官方下载的 gradle-8.14-all.zip 压缩包，直接放入该文件夹（不要解压）；
  5. 重启 Android Studio，重新点击运行按钮，Gradle 会自动识别本地缓存的压缩包，解压并使用，不再联网下载，彻底解决超时问题。

补充：若缓存目录中有多个随机字符文件夹（如本次实操的两个文件夹），保留修改时间较新的文件夹，删除较旧的，避免版本冲突。

坑点2：Gradle 构建报错，提示“plugin is already on the classpath with a different version”（版本冲突）

【原因】手动修改了 build.gradle.kts 配置文件，指定的插件版本（如 7.3.0）与项目默认的版本（如 8.11.1）不一致，导致冲突；

【解决方案】新手建议恢复 Flutter 自动生成的默认配置，避免手动修改，步骤如下：

  1. 打开项目目录 → android → build.gradle.kts；
  2. 将文件内容替换为 Flutter 官方默认配置（如下），保存文件： `plugins { id "com.android.application" version "8.11.1" apply false id "org.jetbrains.kotlin.android" version "1.7.10" apply false }

allprojects { repositories { google() mavenCentral() } }

tasks.register("clean", Delete::class) { delete(rootProject.buildDir) }`

  1. 点击 Android Studio 顶部“Sync Project with Gradle Files”按钮（大象图标），同步配置；
  2. 同步完成后，重新点击运行按钮，版本冲突问题解决。

坑点3：build.gradle.kts 报错，提示“Too many characters in a character literal”（语法错误）

【原因】build.gradle.kts 是 Kotlin DSL 格式，却使用了 Groovy 语法（如单引号、未使用 uri 包裹地址），导致语法解析失败；

【解决方案】严格遵循 Kotlin DSL 语法，新手建议保留默认配置，不要随意修改；若需配置国内镜像，需使用正确语法（如 maven { url = uri("https://maven.aliyun.com/repository/public") }，双引号+uri 包裹）。

坑点4：安装 App 时，提示“INSTALL_FAILED_ABORTED: User rejected permissions”（用户拒绝权限）

【原因】手机弹出安装授权弹窗时，误点“拒绝”，导致 App 安装中止；

【解决方案】重新点击 Android Studio 的运行按钮，当手机再次弹出“安装应用”弹窗时，务必点击“允许/安装”，不要拒绝；若手机未弹出弹窗，检查“开发者选项”中的“USB 安装”是否开启，重新插拔 USB 数据线。

坑点5：Gradle 构建时，提示“NDK not found”“SDK Platform not installed”（依赖缺失）

【原因】首次构建项目时，系统会自动检查并安装 NDK、SDK Platform 等必要组件，若网络中断或安装失败，会提示依赖缺失；

【解决方案】不要手动下载，让 Android Studio 自动安装：

  • 当提示依赖缺失时，点击报错信息中的“Install NDK”“Install SDK Platform”，系统会自动下载并安装；
  • 安装完成后，重新点击运行按钮，构建会继续进行；
  • 若多次安装失败，检查网络是否稳定，或暂时切换手机热点，重新尝试。

五、全程防坑总结（新手必看）

本次实操共遇到 8 个核心坑点，全部源于“路径错误、版本冲突、网络超时、权限拒绝、语法错误”，总结以下核心防坑原则，新手严格遵循，可一次性安装成功：

  1. 所有软件、SDK、项目的 路径无中文、无空格、无特殊字符（最基础、最关键，避免 80% 的坑）；
  2. 全程使用 官方下载渠道，拒绝第三方镜像、破解版，避免版本不匹配、安全风险；
  3. 新手不要随意修改配置文件（如 build.gradle.kts、gradle-wrapper.properties），保留默认配置，先让项目跑起来，后续再按需优化；
  4. Gradle 下载超时，优先使用“官方 Gradle 包手动放入缓存”的方法，绕开网络问题，比修改镜像更稳定；
  5. 真机调试前，务必开启手机“开发者选项”“USB 调试”“USB 安装”，安装 App 时不要拒绝权限；
  6. 遇到报错不要慌，先看报错信息（重点看“What went wrong”部分），对照本教程的坑点解决方案，逐一排查，90% 的问题都能解决；
  7. 首次构建项目耗时较长（10-20 分钟），耐心等待，不要手动停止，避免构建失败。

六、后续优化建议（可选）

当项目能正常运行后，可按需进行以下优化，提升开发效率：

  1. 配置 Flutter 国内镜像（加速依赖下载）：打开命令提示符，输入以下命令（仅需执行一次）： setx PUB_HOSTED_URL https://pub.flutter-io.cn setx FLUTTER_STORAGE_BASE_URL https://storage.flutter-io.cn执行完成后，重启命令行工具，后续下载 Flutter 依赖会更快（仍基于官方渠道，仅加速访问）。
  2. 优化 Gradle 构建速度：打开 Android Studio → File → Settings → Build, Execution, Deployment → Build Tools → Gradle，勾选“Offline work”（离线模式），后续构建会复用已下载的依赖，速度大幅提升；
  3. 安装汉化插件（可选）：打开 Android Studio → Plugins，搜索“Chinese (Simplified)”，安装后重启 IDE，界面会变为中文，适合新手操作。

至此，Win11 系统下 Android Studio 和 Flutter 的安装、配置、运行已全部完成，且全程基于官方下载渠道，避开了所有实操坑点，新手可按照本教程一步步操作，顺利完成 Flutter 开发环境搭建。

avatar
文章
阅读
粉丝