​安装 Flutter SDK​ 的详细步骤

以下是 ​安装 Flutter SDK​ 的详细步骤（以 Windows 为例，其他系统类似）：

​1. 下载 Flutter SDK​

​官方下载（需科学上网）​​

• 访问 Flutter 官网下载最新稳定版（Stable Channel）。

• 选择对应系统的压缩包：

  • Windows: flutter_windows_<version>_stable.zip

  • macOS: flutter_macos_<version>_stable.zip

  • Linux: flutter_linux_<version>_stable.tar.xz

​国内镜像下载（推荐）​​

• 清华大学镜像站：Index of /flutter/flutter_infra_release/releases/ | 清华大学开源软件镜像站 | Tsinghua Open Source Mirror

• 选择最新版本压缩包（如 flutter_windows_3.19.0-stable.zip）。

​2. 解压到本地目录​

• 将下载的压缩包解压到 ​非系统盘​ 的路径（避免权限问题），例如：

  • Windows: C:\src\flutter

  • macOS/Linux: ~/flutter

  ⚠️ 路径中不要包含中文或空格！

​3. 配置环境变量​

​Windows​

1. 右键 ​此电脑​ → ​属性​ → ​高级系统设置​ → ​环境变量。

2. 在 ​系统变量​ 中找到 Path，点击 ​编辑​ → ​新建，添加：

   C:\src\flutter\bin

   （替换为你的实际路径）

3. 点击 ​确定​ 保存。

​macOS/Linux​

编辑 shell 配置文件（如 ~/.bashrc或 ~/.zshrc）：

export PATH="$PATH:/path/to/flutter/bin"

然后运行：

source ~/.bashrc

​4. 验证安装​

打开 ​新的终端窗口​（重要！），运行：

flutter --version

正常输出应显示版本号（如 Flutter 3.19.0）。

如果首次运行卡在 Downloading packages...，参考下文解决网络问题。

​5. 国内用户专属配置​

​配置镜像加速​

在环境变量中添加以下变量（或直接修改 flutter/bin/internal/shared.sh）：

PUB_HOSTED_URL=https://pub.flutter-io.***
FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.***

​Android SDK 镜像​

在 Android Studio 的 build.gradle中替换为阿里云镜像：

repositories {
    maven { url 'https://maven.aliyun.***/repository/google' }
    maven { url 'https://maven.aliyun.***/repository/public' }
}

​6. 运行 flutter doctor​

执行以下命令检查依赖完整性：

flutter doctor

根据提示解决所有标 [!]的问题，例如：

• ​Android 许可证​：运行 flutter doctor --android-licenses并按 y接受。

• ​Android Studio 未安装​：下载并安装 Android Studio。

• ​设备未连接​：连接手机或创建虚拟设备（AVD）。

​7. 创建第一个 Flutter 项目​

flutter create my_app
cd my_app
flutter run

• 选择连接的设备（手机需开启 ​USB 调试模式）。

• 或使用 Android Studio 直接创建 Flutter 项目（需提前安装 Flutter 插件）。

​常见问题解决​

​总结​

1. ​下载解压​ → 2. ​配置环境变量​ → 3. ​验证安装​ → 4. ​解决 flutter doctor问题​ → 5. ​开发！​​

   完成后，你的 Flutter 开发环境就准备好了！ 🎉