Windows 上配置 Flutter 环境：仅用 VS Code 不装 Android Studio 的完整流程-北京尧图网络

1. Windows 上不装 Android Studio 跑 Flutter先搞清楚这套方案到底能做什么如果你在 Windows 上想学 Flutter第一反应多半是去官网下载 Android Studio然后被几个 G 的安装包、漫长的 Gradle 同步和一堆看不懂的 SDK 弹窗劝退。其实 Flutter 官方早就把命令行工具链拆开了你完全可以用 VS Code 命令行 SDK 管理器搭出一套能跑真机、能跑模拟器、能热重载的完整环境全程不碰 Android Studio 的图形界面。这套方案的核心思路是Flutter SDK 负责 Dart 编译和跨平台框架Android SDK 只保留命令行工具cmdline-tools和 platform-toolsVS Code 通过 Flutter 扩展接管编辑、调试、设备选择。Android Studio 里那些图形化的 AVD Manager、SDK Manager本质上都是在调用命令行工具我们直接调就行。适合谁适合已经会一点命令行、想快速验证 Flutter 效果、机器配置一般不想装重型 IDE 的开发者。如果你要做原生 Android 混合开发或者需要频繁改 Gradle 配置那还是装 Android Studio 更省心。但如果你只是写 Flutter 业务代码、调 UI、连真机看效果这套流程足够用。我实测下来整个环境从零到跑起第一个计数器项目大概 40 分钟其中大部分时间花在下载 SDK 上。下面按顺序把每一步的可复制配置都给你包括环境变量、settings.json、flutter doctor 的验证和常见报错处理。2. 前置准备JDK、Android cmdline-tools 与 Flutter SDK 的获取和目录规划在动手之前先把目录规划好后面环境变量才不会乱。我建议统一放在一个盘符下比如E:\dev结构如下E:\dev\ jdk\ android-sdk\ cmdline-tools\latest\bin\ platform-tools\ build-tools\ platforms\ flutter\ bin\ git\JDK 是 Flutter 编译 Android 目标时的依赖。Flutter 现在对 JDK 版本有要求建议用 JDK 17 或 JDK 11不要再用 JDK 8 了新版 Gradle 会报不兼容。去 Oracle 或 Adoptium 下载 JDK 17 的 Windows x64 压缩包解压到E:\dev\jdk解压后目录里应该有bin\java.exe。Android 这边只需要 cmdline-tools。去 Android 开发者官网找 Command line tools only下载 Windows 版 zip。解压后你会得到一个cmdline-tools文件夹里面是bin、lib等。关键一步在cmdline-tools下新建一层latest目录把原来的bin、lib、source.properties全部剪切进latest。最终路径是E:\dev\android-sdk\cmdline-tools\latest\bin\sdkmanager.bat。这一步不做的话sdkmanager 会报 Could not determine SDK root。Flutter SDK 直接用 git clone 最稳能随时切 channel。打开 PowerShellcd E:\dev git clone -b stable https://github.com/flutter/flutter.git如果 clone 慢可以先配镜像环境变量再 clone镜像地址用 Flutter 中国社区提供的$env:PUB_HOSTED_URLhttps://pub.flutter-io.cn $env:FLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cn注意这两个变量要写成系统环境变量才持久临时$env:只对当前窗口有效。Git 本身如果没装去 git-scm.com 下 Windows 版解压或安装后把cmd目录加进 Path。3. 可复制配置环境变量、settings.json 与 sdkmanager 安装命令环境变量是这套方案最容易翻车的地方。右键此电脑→属性→高级系统设置→环境变量在用户变量里新建以下几条变量名变量值JAVA_HOMEE:\dev\jdkANDROID_HOMEE:\dev\android-sdkANDROID_SDK_ROOTE:\dev\android-sdkPUB_HOSTED_URLhttps://pub.flutter-io.cnFLUTTER_STORAGE_BASE_URLhttps://storage.flutter-io.cn然后在 Path 里追加%JAVA_HOME%\bin %ANDROID_HOME%\cmdline-tools\latest\bin %ANDROID_HOME%\platform-tools E:\dev\flutter\bin E:\dev\git\cmdPath 里不要写%ANDROID_HOME%\build-tools和%ANDROID_HOME%\platforms这两个目录是 sdkmanager 下载后才生成的提前写进去如果目录不存在某些工具解析 Path 时会报错。接下来装 Android SDK 组件。打开 PowerShell进到E:\dev\android-sdk\cmdline-tools\latest\bin执行.\sdkmanager.bat --list先看列表确认能连上。然后安装必需组件.\sdkmanager.bat platform-tools build-tools;34.0.0 platforms;android-34安装过程中会弹许可证输入y回车。如果你要用 Google 自带的 Android 模拟器还需要装 emulator 和系统镜像.\sdkmanager.bat emulator system-images;android-34;google_apis;x86_64装完后用.\sdkmanager.bat --licenses把所有许可证一次性接受避免后面 flutter doctor 报 license 未接受。VS Code 这边先装 Flutter 扩展和 Dart 扩展。然后打开设置CtrlShiftP → Open User Settings JSON加入以下配置把 SDK 路径指死避免它去猜{ dart.flutterSdkPath: E:\\dev\\flutter, dart.sdkPath: E:\\dev\\flutter\\bin\\cache\\dart-sdk, flutter.androidSdkPath: E:\\dev\\android-sdk, dart.checkForSdkUpdates: false, editor.formatOnSave: true, dart.previewFlutterUiGuides: true }dart.sdkPath指向 Flutter 自带的 Dart SDK这样不用单独装 Dart。flutter.androidSdkPath这个键在部分版本里是dart.flutterAndroidSdkPath如果 flutter doctor 仍报找不到 Android SDK就两个都写上。4. 验证请求flutter doctor 逐项排查与首个项目跑通环境变量配完关掉所有终端重新开一个让 Path 生效。执行flutter --version flutter doctor -vflutter doctor会输出几大项Flutter、Android toolchain、Chrome、VS Code、Connected device。理想状态下 Android toolchain 应该是绿色勾。如果报 Android license status unknown执行flutter doctor --android-licenses一路y。如果报 Unable to locate Android SDK检查ANDROID_HOME是否指向E:\dev\android-sdk且该目录下确实有cmdline-tools\latest\bin。真机调试前手机打开开发者选项和 USB 调试部分机型还要开USB 安装。用数据线连电脑执行flutter devices能看到设备 ID 就说明 platform-tools 里的 adb 正常工作。如果看不到在手机弹窗里选允许 USB 调试然后adb kill-server adb start-server重启一下。创建项目cd E:\projects flutter create my_first_app cd my_first_app code .VS Code 打开后按 F5 或点运行→启动调试它会让你选设备。选真机或模拟器第一次会跑 Gradle 下载依赖时间取决于网络。跑起来后改lib/main.dart里的文字按 CtrlS 保存热重载几乎瞬间生效。模拟器的话如果你装了 emulator 和系统镜像可以用命令行创建 AVDavdmanager create avd -n pixel34 -k system-images;android-34;google_apis;x86_64 -d pixel_6 emulator -avd pixel34VS Code 里也能通过 Flutter 扩展的设备选择器直接启动模拟器。5. 本篇常见错排查401、local proxy failed、reading choices 与 OAuth 报错报错一flutter doctor卡在 Running Gradle task 或下载超时。这是 Gradle 和 Maven 仓库访问慢导致的。在项目android/build.gradle里把仓库换成国内镜像或者在gradle.properties里加代理配置。注意这里说的是构建仓库镜像不是网络代理工具直接用阿里云的 Maven 镜像即可buildscript { repositories { maven { url https://maven.aliyun.com/repository/google } maven { url https://maven.aliyun.com/repository/public } } }报错二401 Unauthorized或reading choices解析失败。这种通常出现在你调用了某个需要鉴权的模型 API 或包管理接口时。检查你的 API Key 是否过期、Base URL 是否写错。如果是用 TaoToken 这类聚合服务确认请求头里的Authorization: Bearer key格式正确且 Base URL 指向https://taotoken.net/api。reading choices报错多半是返回体不是标准 JSON先 curl 一下看原始响应。报错三local proxy failed或连接被拒绝。说明你的终端或 VS Code 配置了本地代理端口但代理进程没起来。检查环境变量HTTP_PROXY、HTTPS_PROXY是否指向了一个不存在的端口。直接清掉这两个变量再试Remove-Item Env:HTTP_PROXY -ErrorAction SilentlyContinue Remove-Item Env:HTTPS_PROXY -ErrorAction SilentlyContinue报错四OAuth 相关报错比如OAuth token expired或invalid_grant。如果你在 VS Code 里登录了某些 AI 编码插件如 Claude Code、Cline它们的 OAuth token 会过期。重新走一遍登录流程或者在插件设置里清除凭据重新授权。如果是 Codex 的auth.json检查文件里的 token 字段是否完整路径通常在~/.codex/auth.json。报错五cmdline-tools组件缺失。flutter doctor 提示 cmdline-tools component is missing。说明你装的是旧版 SDK 或者latest目录结构不对。重新确认E:\dev\android-sdk\cmdline-tools\latest\bin\sdkmanager.bat存在然后sdkmanager --install cmdline-tools;latest。6. 从环境到编码用 TaoToken 接入模型能力与长期 Coding Plan 的选择环境跑通之后你可能会想在 VS Code 里接入 AI 编码助手来加速 Flutter 开发。这时候需要一个稳定的模型 API 入口。TaoToken 提供统一的 API 网关Base URL 是https://taotoken.net/api你可以在 API Keys 页面生成 Key然后在 VS Code 的插件里填入 Base URL、Key 和 Model ID 三件套。以 Cline 或 Claude Code 这类插件为例配置通常长这样{ baseUrl: https://taotoken.net/api, apiKey: sk-你的key, model: claude-sonnet-4-20250514 }如果你用的是 Codex 的auth.json格式类似{ api_key: sk-你的key, base_url: https://taotoken.net/api }填完之后在插件里发一条测试消息确认能正常返回。如果报 401去 Console 检查 Key 是否启用如果报模型不存在去模型对话页面确认当前账号可用的 Model ID。对于长期写 Flutter 项目、需要频繁调用 Agent 能力的场景可以看下 Coding Plan它比按量计费更适合高频编码。接入文档里有各插件的详细配置步骤遇到 OAuth 或 local proxy failed 这类报错文档里也有对应排查章节。环境搭好只是开始真正省时间的是把热重载、真机调试和 AI 辅助编码串成一条流水线。我自己的习惯是 VS Code 左边开终端跑flutter run右边开 AI 插件改代码保存即热重载改完直接看手机效果。这套流程跑顺之后你基本不会再想打开 Android Studio 了。

Windows 上配置 Flutter 环境：仅用 VS Code 不装 Android Studio 的完整流程

相关推荐

GPUStack Day 0 支持 Kimi-K3：8×B300 上 vLLM 与 SGLang 推理实测与 TaoToken 统一 Key 接入

一文看懂 AI Agent 全栈架构：从运行环境到大模型基座的系统化落地指南（TaoToken 统一 Key 接入篇）

2026私有化OpenClaw替代方案商深度盘点：企业级智能体安全合规与国产化选型建议｜TaoToken统一Key接入实践

更多资讯

企管论文别再“一个 AI 用到黑”：从选题到降重，我的工具分工清单 [特殊字符]

C# WinForm 下拉框切换窗体样式：主题类与递归遍历控件重绘指南

格式转换任务为何要关闭思考？JSON 结构化输出场景下的思考死循环实测

端侧 SLM 显存保活术：在 4GB 内存板卡上实现轻量 PagedAttention 与 KV 缓存分块

三菱CNC数据采集C#源码解析：从协议到落库的完整实践

8G显存本地跑大模型代码生成：从翻车到落地的完整实操指南

今日更新

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本周精选

CMOS设计三大物理效应：体效应、沟道长度调制与亚阈值导电

微信小程序在线阅读毕设全解析：Java后端+MySQL+避坑实战

Android音频问题五层分析法：从App到Codec的系统化诊断

本月热门

我发现了一个新思路：用 Remotion + Claude Code 像写代码一样自动化生成短视频

Windows下 Codex 中 Chrome 和 Computer Use 插件不可用问题排查及解决参考方式：TaoToken 统一 Key 配置与验证

2026 大模型集体涨价：用 Python 做企业 Token 成本测算与选型避坑（附配置）

读完文章，想聊聊您的网站？