统信UOS搭建Flutter环境需按架构选择方案：AMD64推荐Git克隆稳定分支并配国内镜像；网络受限可用Gitee镜像；ARM64须用社区ARM64版Android Studio及OH适配SDK；最后必须补全Android工具链并配置环境变量。
如果您在统信UOS系统上尝试搭建Flutter开发环境，但遇到SDK下载失败、命令不可识别或Android工具链检测不通过等问题，则很可能是由于系统架构适配、源地址不可达或环境变量配置不完整所致。以下是针对统信UOS（基于Debian/Ubuntu的ARM64或AMD64架构）的多种可行安装路径：
一、使用Git克隆官方稳定分支（推荐AMD64平台）
该方法适用于统信UOS x86_64（AMD64）版本，通过Git获取经过验证的稳定分支代码，避免手动下载压缩包校验失败或网络中断问题。
1、打开终端，执行以下命令安装Git（如未预装）：
sudo apt update && sudo apt install -y git
2、创建无中文、无空格的安装目录，例如：
mkdir -p $HOME/development/flutter
3、进入目录并克隆Flutter官方稳定分支：
cd $HOME/development/flutter
git clone -b stable https://github.com/flutter/flutter.git .
4、配置国内镜像环境变量（关键步骤，否则后续pub依赖拉取将超时）：
echo 'export PUB_HOSTED_URL="https://pub.flutter-io.cn"' >> $HOME/.bashrc
echo 'export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"' >> $HOME/.bashrc
source $HOME/.bashrc
5、将Flutter bin目录加入PATH：
echo 'export PATH="$PATH:$HOME/development/flutter/bin"' >> $HOME/.bashrc
source $HOME/.bashrc
二、使用Gitee镜像加速下载（适用于网络受限场景）
当GitHub访问不稳定时，Gitee提供了Flutter仓库的同步镜像，可显著提升下载成功率，尤其适合企业内网或教育网用户。
1、确保已安装curl与unzip：
sudo apt install -y curl unzip
2、创建SDK安装路径：
mkdir -p $HOME/sdk/flutter
3、从Gitee镜像下载并解压（以3.29.3稳定版为例）：
curl -L https://gitee.com/mirrors/Flutter/repository/archive/stable.zip -o flutter-stable.zip
unzip flutter-stable.zip -d $HOME/sdk/
4、重命名解压后的文件夹为flutter：
mv $HOME/sdk/Flutter-* $HOME/sdk/flutter
5、配置环境变量并生效：
echo 'export FLUTTER_HOME=$HOME/sdk/flutter' >> $HOME/.bashrc
echo 'export PATH="$FLUTTER_HOME/bin:$PATH"' >> $HOME/.bashrc
source $HOME/.bashrc
三、ARM64平台专用方案：采用社区ARM64适配版Android Studio + Flutter SDK
统信UOS在华为鲲鹏、飞腾等国产ARM64设备上运行时，需使用原生ARM64构建的开发工具链，否则Android Studio无法启动或Flutter doctor会报“platform-tools not found”错误。
1、下载社区维护的ARM64版Android Studio：
wget https://github.com/moneytoo/AndroidStudio-ARM64/releases/download/2023.1.1/android-studio-2023.1.1-arm64.tar.gz
2、解压并安装到系统级路径：
tar -xzf android-studio-2023.1.1-arm64.tar.gz
sudo mv android-studio /opt/
3、启动Android Studio并完成首次配置（勾选Android SDK、Platform-Tools、Command-line Tools）
4、单独下载适配OpenHarmony与ARM64的Flutter SDK（非官方主干）：
git clone -b oh-3.27.4-dev https://gitcode.com/openharmony-tpc/flutter_flutter.git $HOME/sdk/flutter-oh
5、设置专用环境变量指向该SDK：
echo 'export FLUTTER_HOME_ARM64=$HOME/sdk/flutter-oh' >> $HOME/.bashrc
echo 'export PATH="$FLUTTER_HOME_ARM64/bin:$PATH"' >> $HOME/.bashrc
source $HOME/.bashrc
四、验证与补全Android工具链（必需步骤）
即使Flutter SDK安装成功，统信UOS默认不包含Android构建所需的关键组件，必须手动补全cmdline-tools与Android SDK Platform-Tools，否则flutter doctor将始终显示[X] Android toolchain错误。
1、确认Android SDK路径（通常为/opt/android-sdk或$HOME/Android/Sdk）：
ls -l /opt/android-sdk/cmdline-tools/latest/bin/sdkmanager 2>/dev/null || echo "cmdline-tools缺失，请执行下一步"
2、若缺失，手动创建目录并下载最新cmdline-tools：
mkdir -p $HOME/Android/Sdk/cmdline-tools/latest
cd $HOME/Android/Sdk/cmdline-tools/latest
wget https://dl.google.com/android/repository/commandlinetools-linux-11076708_latest.zip
unzip commandlinetools-linux-11076708_latest.zip -d $HOME/Android/Sdk/cmdline-tools/latest
3、接受所有Android SDK许可证：
$HOME/Android/Sdk/cmdline-tools/latest/bin/sdkmanager --licenses
4、安装必要组件：
$HOME/Android/Sdk/cmdline-tools/latest/bin/sdkmanager "platform-tools" "platforms;android-34" "build-tools;34.0.0"
5、设置ANDROID_HOME环境变量：
echo 'export ANDROID_HOME=$HOME/Android/Sdk' >> $HOME/.bashrc
echo 'export PATH="$ANDROID_HOME/platform-tools:$PATH"' >> $HOME/.bashrc
source $HOME/.bashrc
五、执行最终诊断并启用鸿蒙支持（如需混合开发）
统信UOS用户若计划开发鸿蒙兼容应用，需额外启用OpenHarmony构建支持，该步骤依赖特定Flutter SDK分支及DevEco Studio协同配置。
1、关闭所有终端，重新打开一个终端窗口
2、运行诊断命令：
flutter --version
3、检查是否识别鸿蒙支持：
flutter doctor -v | grep -A5 "HarmonyOS"
4、若输出中未显示[✓] HarmonyOS support installed，需切换至含OH支持的SDK分支：
cd $FLUTTER_HOME
git fetch origin oh-3.27.4-dev
git checkout oh-3.27.4-dev
flutter upgrade --force
5、配置DevEco Studio中的OpenHarmony SDK路径（需提前在D:\HarmonyOS\OpenHarmony\Sdk或对应路径完成下载）
