Flutter 环境搭建实录-平芜编程栈

Flutter环境搭建日志，记录了我在 Windows 10 系统上从零开始配置 Flutter 开发环境的完整过程。期间遇到了网络连接、环境变量、sdk下载、Android Studio 配置等一系列问题，最终全部解决。

软件	用途
VS Code	代码编辑器（写 Flutter 代码的地方）
Flutter SDK	Flutter 核心开发工具包
Dart SDK	随 Flutter SDK 一起安装
Android Studio	提供 Android SDK 和模拟器（不一定要用来写代码）
Git	Flutter SDK 依赖 Git 进行版本管理（已安装，省略这一步）

直接官网下载，按照官网的步骤安装就好了

配置用户设置文件settings.json文件

{ "dart.flutterSdkPath": "D:\\flutter" }

VS Code 扩展商店中搜索 “flutter”，点击安装由官方发布的flutter插件(自动安装Dart插件)

下载完成后会弹出一个提示：

The Flutter SDK was downloaded. Would you like to add it to your PATH?

点击了Add SDK to PATH，那么它会自动帮你配置好环境变量PATH，添加D:\flutter\bin

推荐同时安装Flutter Widget Snippets插件

下载时，发现初始化非常缓慢

点击 “Cancel” 按钮，重新打开 VS Code，在终端输入命令

flutter doctor -v

这一步操作的是手动运行 flutter doctor，-v是 verbose（详细模式），会打印出进度信息

问题分析：VS Code 在尝试从pub.dev下载依赖时遇到了网络问题（socket error）

此时我想验证一下电脑上到底有没有装好 flutter sdk

打开D盘查看flutter/bin文件夹下有flutter.bat，SDK 文件在

打开CMD窗口验证，输入以下命令

flutter --version

问题分析：你的网络无法正常访问pub.dev（ Flutter 的官方包仓库），导致flutter --version卡在下载依赖这一步。

按Ctrl + C终止，检查vpn是否关闭，然后临时设置国内镜像（仅当前窗口有效）

在CMD输入命令（一行一行地输入并回车）：

set PUB_HOSTED_URL=https://pub.flutter-io.cn set FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn flutter --version

Flutter 从国内的镜像站下载依赖，速度快了很多，不会再出现socket error的错误

以下命令在CMD中操作（是一行一行地输入并回车）

set PUB_HOSTED_URL=https://pub.flutter-io.cn set FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn flutter --version flutter doctor -v

以下命令在VS Code的终端操作（是一行一行地输入并回车）

$env:PUB_HOSTED_URL="https://pub.flutter-io.cn" $env:FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn" flutter --version flutter doctor -v

好的，重新回到VS Code的终端窗口

检查项	状态	说明
Flutter SDK	✅ 完美	已正确安装，并使用了国内镜像，网络配置很棒。
Windows 系统	✅ 完美	符合所有开发要求。
Chrome 浏览器	✅ 完美	可以立即进行 Web 应用开发。
Android 工具链	❌ 缺失	这是主要问题，需要安装 Android Studio 来提供 SDK 和模拟器。
Visual Studio	⚠️ 组件缺失	只影响 Windows 桌面应用开发，可以先不管。
网络资源	⚠️ 连接超时	检查 GitHub 时超时，不影响国内镜像的使用。

直接官网下载，按照官网的步骤安装就好了

安装完成，在vs code终端再次查看还缺少哪些开发必备的组件

$env:PUB_HOSTED_URL="https://pub.flutter-io.cn" $env:FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn" flutter doctor -v

打开 Android Studio 的 SDK Manager

切换到 SDK Tools 选项卡，勾选 "Android SDK Command-line Tools (latest)"

点击"Apply"按钮，在弹出的确认对话框中点击 "OK"，下载完成后点击 "Finish"

在 VS Code 终端中运行：

$env:PUB_HOSTED_URL="https://pub.flutter-io.cn" $env:FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn" flutter doctor --android-licenses

然后一路输入y（yes），直到所有许可证都同意完毕。

📋 诊断结果解读