Flutter SDK安装与国内镜像配置全流程（Windows/macOS/Linux）

一、准备工作

在开始之前，请确保你的系统满足Flutter的最低要求：

• Windows：Windows 7 SP1或更高版本（64位），Git for Windows，PowerShell 5.0+
• macOS：macOS 10.14 (Mojave)或更高版本，Xcode（用于iOS开发）
• Linux：64位Linux，Git，bash，curl，mkdir，rm，unzip等常用工具

二、下载Flutter SDK

访问Flutter官方发布页，选择对应系统的SDK压缩包。由于网络原因，推荐使用国内镜像加速下载，例如：

    # 清华大学镜像站https://mirrors.tuna.tsinghua.edu.cn/flutter/  

三、各系统安装步骤

Windows

1. 下载flutter_windows_*stable.zip，解压到你希望的目录（例如C:\src�lutter）。
2. 将flutter�in路径添加到系统环境变量PATH中。
3. 新建系统变量PUB_HOSTED_URL，值为https://mirrors.tuna.tsinghua.edu.cn/dart-pub/。
4. 新建系统变量FLUTTER_STORAGE_BASE_URL，值为https://mirrors.tuna.tsinghua.edu.cn/flutter/。
5. 打开PowerShell，运行flutter doctor检查依赖。

macOS

1. 下载flutter_macos*stable.zip，解压到~/development/flutter（可自定义）。
2. 编辑~/.bash_profile或~/.zshrc，添加：

   export PATH="$PATH:$HOME/development/flutter/bin"export PUB_HOSTED_URL=https://mirrors.tuna.tsinghua.edu.cn/dart-pub/export FLUTTER_STORAGE_BASE_URL=https://mirrors.tuna.tsinghua.edu.cn/flutter/

3. 执行source ~/.bash_profile（或对应文件）使配置生效。
4. 运行flutter doctor验证。

Linux

1. 下载flutter_linux*_stable.tar.xz，解压到~/development/flutter。
2. 编辑~/.bashrc，添加与macOS相同的环境变量配置。
3. 执行source ~/.bashrc。
4. 运行flutter doctor完成安装。

四、配置国内镜像详解

通过设置PUB_HOSTED_URL和FLUTTER_STORAGE_BASE_URL两个环境变量，即可将Flutter和Dart包的下载源指向国内镜像。常用的镜像有：

• 清华大学镜像：https://mirrors.tuna.tsinghua.edu.cn/flutter/
• 阿里云镜像：https://mirrors.aliyun.com/flutter/
• 腾讯云镜像：https://mirrors.cloud.tencent.com/flutter/

配置完成后，执行flutter doctor -v，如果看到镜像地址已变更，则说明国内镜像配置成功。

五、常见问题

• Flutter SDK安装后无法运行？ 检查环境变量是否正确配置，并重启终端。
• 国内镜像配置不生效？ 确保变量名拼写正确，且没有多余空格。
• flutter doctor报错Android licenses未接受？ 运行flutter doctor --android-licenses接受协议。

通过以上步骤，你已经完成了Flutter环境搭建并享受镜像加速带来的快速体验。现在可以开始你的第一个Flutter项目了！