Flutter 国内安装指南

适用于 macOS + FVM，目标是稳定安装指定 Flutter 版本，并尽量避开 Google 官方源访问慢的问题。

推荐镜像组合

实测后建议使用：

# Dart / Flutter 依赖包
export PUB_HOSTED_URL=https://pub.flutter-io.cn

# Flutter artifacts / Dart SDK / iOS tools 等二进制资源
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

# FVM 拉取 Flutter SDK git 仓库
export FVM_FLUTTER_URL=https://mirrors.bfsu.edu.cn/git/flutter-sdk.git

# FVM 缓存目录
export FVM_CACHE_PATH="$HOME/fvm"

# 让全局 flutter 指向 FVM 默认版本
export PATH="$HOME/fvm/default/bin:$HOME/.pub-cache/bin:$PATH"

把上面内容写入 ~/.zshrc，然后执行：

source ~/.zshrc

安装 FVM

如果还没安装 FVM：

brew tap leoafarias/fvm
brew install fvm

确认版本：

fvm --version

配置 FVM

fvm config \
  --cache-path "$HOME/fvm" \
  --flutter-url https://mirrors.bfsu.edu.cn/git/flutter-sdk.git \
  --no-use-git-cache

说明：

• --flutter-url 指定 FVM 拉 Flutter SDK 的 git 镜像。
• --no-use-git-cache 避免首次创建共享 git cache 卡住；只装少量版本时更直接。

安装 Flutter

例如安装 3.35.4：

fvm install 3.35.4

安装成功后会看到类似：

Flutter 3.35.4 • channel stable • https://mirrors.bfsu.edu.cn/git/flutter-sdk.git
Tools • Dart 3.9.2

设置项目版本

进入项目目录：

cd /path/to/your/flutter/project
fvm use 3.35.4

如果当前只有这一个版本，也可以设为全局默认：

fvm global 3.35.4

确认：

fvm list
flutter --version
fvm flutter --version

iOS 模拟器启动注意

如果 simctl 不可用，通常是 Xcode 没被选中：

xcode-select -p

如果输出是：

/Library/Developer/CommandLineTools

可以临时使用完整 Xcode：

export DEVELOPER_DIR=/Applications/Xcode.app/Contents/Developer

然后启动模拟器并运行：

fvm flutter devices
fvm flutter run -d <device-id>

清理建议

正常安装后，$HOME/fvm/versions/<version> 占用 2GB+ 是正常的，包含：

• Flutter SDK git 仓库
• Dart SDK
• iOS/macOS artifacts
• Flutter tools

不要随便清 bin/cache，否则下次运行会重新下载。

可以安全清理的通常是：

rm -f "$HOME/fvm/cache.git.lock"
rm -rf "$HOME/fvm/cache.git.tmp."*

如果确认没有正在运行的 fvm install，这些是中断安装留下的临时文件。