项目flutter运行环境汇总
[环境基线] - OS: Windows 10 22H2 (10.0.19045.6466) - Flutter: 3.41.3 (stable), framework 48c32af034, engine 327ed81450 - Dart: 3.11.1 [Android] - Android SDK: 36.1.0 - Platform: android-36.1 - Build-tools: 36.1.0 - Java: OpenJDK 21.0.9 - Emulator: 36.4.9.0 [Web] - Chrome: 147.0.7727.56 - Edge: 146.0.3856.109 [可用运行目标] - Android Emulator / Windows Desktop / Chrome / Edge [注意] - 未安装 Visual Studio（仅影响 Windows 桌面构建）android端
下面sdk组件必须安装，否则android的gradle一直报错
SDK Tools 各项工具详细说明（纯表格、无状态）
一、所有工具总览表
表格
工具名称 核心作用 必备程度 主要包含工具 Android SDK Build-Tools 编译、打包、签名、优化 APK/AAB 必须 aapt2、d8/r8、apksigner、zipalign、aidl Android SDK Platform-Tools 电脑与设备通信、调试、安装应用 必须 adb、fastboot、sqlite3、systrace Android SDK Command-line Tools SDK/AVD 命令行管理、分析工具 必须 sdkmanager、avdmanager、apkanalyzer、lint Android Emulator 在电脑上运行 Android 虚拟设备 建议安装 模拟器引擎、界面、传感器模拟 Emulator hypervisor driver 模拟器硬件虚拟化加速驱动 建议安装 Intel/AMD 虚拟化驱动（替代 HAXM） NDK (Side by side) C/C++ 原生代码编译、生成 .so 库 可选 编译器、链接器、C/C++ 标准库、头文件 CMake NDK 构建配置工具，管理 C/C++ 编译 可选 cmake、ninja、读取 CMakeLists.txt 二、SDK Tools 与 SDK Platforms 区别表
表格
对比项 SDK Tools SDK Platforms 本质 开发、编译、调试、打包的工具集 对应 Android 版本的系统开发环境 内容 Build-Tools、Platform-Tools、Emulator、NDK、CMake 等 android.jar API、系统镜像、源码、资源 版本 工具独立版本，不绑定 Android 版本 按 API Level / Android 版本区分（API 34、35…） 作用 把代码变成 APK、连接设备、调试运行 提供系统 API、编译依赖、模拟器系统镜像 是否通用 一套工具支持所有 Android 版本 每个版本独立，需要哪个装哪个 依赖 所有项目必须安装 按项目 compileSdk 安装对应版本
ios端
表格
命令 作用（核心用途） 为什么 Flutter iOS 必须查这个 xcodebuild -version查看Xcode 实际构建版本 1. 确定编译 iOS 工程的真实 Xcode 版本2. Flutter 编译 iOS 依赖此版本，比直接看 Xcode 界面更准3. 排查「编译失败、SDK 不匹配」问题 xcode-select -p查看当前系统使用的 Xcode 路径 1. 一台电脑可能装多个 Xcode，必须确认当前生效的是哪一个2. 解决「Xcode 路径错误、命令行工具不生效」的根因 swift --version查看Swift 编译器版本 1. Flutter iOS 插件 / 原生代码大量使用 Swift2. Swift 版本不匹配会直接导致编译报错、插件无法运行 ruby -v查看Ruby 版本 1. CocoaPods（iOS 依赖管理工具）基于 Ruby 运行2. Ruby 版本过低 / 过高都会导致 pod 无法安装 pod --version查看CocoaPods 版本 1. Flutter iOS 项目必须用 CocoaPods 管理原生依赖2. 版本不兼容是「pod install 失败、iOS 运行报错」最常见原因 gem -v查看RubyGems 版本 1. Ruby 包管理工具，用来安装 / 更新 CocoaPods2. 排查「无法安装 pod、gem 权限报错」问题 bundler -v查看Bundler 版本（可选） 1. 统一团队 Ruby 依赖版本，避免「我这能跑你那不行」2. 企业级 / 标准化项目必查，保证环境完全一致
工具 / 命令 作用 是否 Xcode 自带 说明 xcodebuild -versionXcode 构建工具，用来编译 iOS 项目 ✅自带 Xcode 核心组件，安装 Xcode 就有 xcode-select -p管理 Xcode 命令行工具路径 ✅自带 macOS 系统自带，Xcode 安装后自动配置 swift --versionSwift 编译器，iOS 开发语言 ✅自带 Xcode 自带，Flutter iOS 编译依赖它 ruby -vRuby 环境，CocoaPods 依赖 ✅macOS 自带 系统预装，不用你装 pod --versionCocoaPods，管理 iOS 第三方依赖 ❌需要手动装一次 唯一需要你手动安装的工具，一条命令搞定 gem -vRuby 包管理器，安装 CocoaPods 用 ✅macOS 自带 系统预装 bundler -vRuby 依赖管理工具，可选 ❌ 可选，非必须 一般项目不用，装不装都行 sudo gem install cocoapods