02 安装Flutter SDK把我难死了

4 阅读2分钟

你现在建议手动安装 Flutter SDK,别先依赖 VS Code 插件自动下载,因为它已经在 Google 下载源那里超时了。

Flutter SDK 本质上就是一个文件夹,里面有 flutter 命令、Dart SDK、构建工具等。安装过程就是:

  1. 下载 Flutter SDK 压缩包
  2. 解压成 flutter 文件夹
  3. flutter/bin 加到环境变量 PATH
  4. 配置中国镜像
  5. 执行 flutter doctor 检查环境

你这台机器日志里是 darwin-arm64,所以大概率是 Apple 芯片 Mac,下载 macOS arm64 版本。

第一步:打开终端

打开 macOS 的「终端」App,然后一行一行复制下面的命令。

先配置中国镜像:

echo 'export PUB_HOSTED_URL=https://pub.flutter-io.cn' >> ~/.zshrc
echo 'export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn' >> ~/.zshrc
source ~/.zshrc

这一步的作用是告诉 Flutter:

以后别从 Google 下载,改从国内镜像下载。

Flutter 官方中国网络文档也是这么配置的:
docs.flutter.cn/community/c…

第二步:下载 Flutter SDK

打开这个页面:

docs.flutter.cn/install/arc…

选择:

Stable channel
macOS
arm64 / Apple Silicon

下载 SDK 压缩包。

如果下载链接还是 storage.googleapis.com 开头,就把前面的域名换成:

https://storage.flutter-io.cn

比如官方文档给的规则就是:

https://storage.googleapis.com/...

换成:

https://storage.flutter-io.cn/...

第三步:解压到固定位置

假设你下载的文件在「下载」目录,继续在终端输入:

mkdir -p ~/development
cd ~/development
unzip ~/Downloads/flutter_macos*.zip

解压后你应该会得到这个文件夹:

/Users/wuhuaqing/development/flutter

第四步:配置 PATH

PATH 的意思是:你在终端输入 flutter 时,系统要去哪里找这个命令。

输入:

echo 'export PATH="$PATH:$HOME/development/flutter/bin"' >> ~/.zshrc
source ~/.zshrc

然后检查:

flutter --version

如果能看到 Flutter 版本号,说明 SDK 装好了。

第五步:检查环境

输入:

flutter doctor

这个命令会检查:

Flutter SDK 是否正常
Dart 是否正常
Xcode 是否安装
Android Studio 是否安装
模拟器是否可用
VS Code 插件是否可用

之后创建项目

比如你想在当前仓库下面创建 Flutter 客户端:

cd /Users/wuhuaqing/Documents/hll/IMP
flutter create client
cd client
flutter run

一句话总结:你现在不是代码问题,是 SDK 下载源问题。先配置中国镜像,再手动下载 Flutter SDK,解压后把 flutter/bin 加进 PATH,最后跑 flutter doctor