项目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 -version Xcode 构建工具，用来编译 iOS 项目 ✅ 自带 Xcode 核心组件，安装 Xcode 就有

xcode-select -p 管理 Xcode 命令行工具路径 ✅ 自带 macOS 系统自带，Xcode 安装后自动配置

swift --version Swift 编译器，iOS 开发语言 ✅ 自带 Xcode 自带，Flutter iOS 编译依赖它

ruby -v Ruby 环境，CocoaPods 依赖 ✅ macOS 自带 系统预装，不用你装

pod --version CocoaPods，管理 iOS 第三方依赖 ❌ 需要手动装一次 唯一需要你手动安装的工具，一条命令搞定

gem -v Ruby 包管理器，安装 CocoaPods 用 ✅ macOS 自带 系统预装

bundler -v Ruby 依赖管理工具，可选 ❌ 可选，非必须一般项目不用，装不装都行
复制代码
sudo gem install cocoapods

工具名称	核心作用	必备程度	主要包含工具
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
本质	开发、编译、调试、打包的工具集	对应 Android 版本的系统开发环境
内容	Build-Tools、Platform-Tools、Emulator、NDK、CMake 等	android.jar API、系统镜像、源码、资源
版本	工具独立版本，不绑定 Android 版本	按 API Level / Android 版本区分（API 34、35...）
作用	把代码变成 APK、连接设备、调试运行	提供系统 API、编译依赖、模拟器系统镜像
是否通用	一套工具支持所有 Android 版本	每个版本独立，需要哪个装哪个
依赖	所有项目必须安装	按项目 compileSdk 安装对应版本

命令	作用（核心用途）	为什么 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 -version`	Xcode 构建工具，用来编译 iOS 项目	✅ 自带	Xcode 核心组件，安装 Xcode 就有
`xcode-select -p`	管理 Xcode 命令行工具路径	✅ 自带	macOS 系统自带，Xcode 安装后自动配置
`swift --version`	Swift 编译器，iOS 开发语言	✅ 自带	Xcode 自带，Flutter iOS 编译依赖它
`ruby -v`	Ruby 环境，CocoaPods 依赖	✅ macOS 自带	系统预装，不用你装
`pod --version`	CocoaPods，管理 iOS 第三方依赖	❌ 需要手动装一次	唯一需要你手动安装的工具，一条命令搞定
`gem -v`	Ruby 包管理器，安装 CocoaPods 用	✅ macOS 自带	系统预装
`bundler -v`	Ruby 依赖管理工具，可选	❌ 可选，非必须	一般项目不用，装不装都行