知识库

Appearance

Flutter 安装与环境配置 ​

系统要求 ​

Windows 系统 ​

  • 操作系统：Windows 10 或更高版本（64位）
  • 磁盘空间：至少 1.64 GB（不包括 IDE 和其他工具）
  • 工具：Git for Windows

macOS 系统 ​

  • 操作系统：macOS (64-bit)
  • 磁盘空间：至少 2.8 GB（不包括 IDE 和其他工具）
  • 工具：Xcode（用于 iOS 开发）

Linux 系统 ​

  • 操作系统：Ubuntu 18.04 或更高版本（64-bit）
  • 磁盘空间：至少 600 MB（不包括 IDE 和其他工具）

安装步骤 ​

1. 下载 Flutter SDK ​

  1. 访问 Flutter 官网 下载最新版本的 Flutter SDK
  2. 解压下载的压缩包到你选择的目录，例如：
    • Windows: C:\src\flutter
    • macOS: ~/development/flutter
    • Linux: ~/development/flutter

2. 配置环境变量 ​

Windows ​

  1. 右键点击「此电脑」→「属性」→「高级系统设置」→「环境变量」
  2. 在「系统变量」中找到「Path」，点击「编辑」
  3. 添加 Flutter 的 bin 目录路径，例如：C:\src\flutter\bin
  4. 点击「确定」保存更改

macOS/Linux ​

  1. 打开终端
  2. 编辑 shell 配置文件（如 .bashrc、.zshrc 等）
  3. 添加以下行：
    bash
    export PATH="$PATH:/path/to/flutter/bin"
  4. 保存文件并执行 source ~/.bashrc 或 source ~/.zshrc 使更改生效

3. 运行 flutter doctor ​

打开终端（Windows 下打开命令提示符或 PowerShell），运行以下命令：

bash
flutter doctor

这个命令会检查你的环境并报告任何问题。按照提示解决问题，直到所有检查都通过。

配置开发工具 ​

Android Studio ​

  1. 下载并安装 Android Studio
  2. 打开 Android Studio，进入「插件」设置
  3. 搜索并安装「Flutter」插件
  4. 重启 Android Studio

VS Code ​

  1. 下载并安装 VS Code
  2. 打开 VS Code，进入扩展市场
  3. 搜索并安装「Flutter」扩展
  4. 重启 VS Code

验证安装 ​

创建一个新的 Flutter 项目来验证安装是否成功：

使用命令行 ​

bash
# 创建新项目
flutter create my_app

# 进入项目目录
cd my_app

# 运行应用
flutter run

使用 IDE ​

Android Studio ​

  1. 打开 Android Studio
  2. 选择「Start a new Flutter project」
  3. 选择「Flutter Application」
  4. 填写项目信息并点击「Finish」
  5. 等待项目创建完成，然后点击「Run」按钮运行应用

VS Code ​

  1. 打开 VS Code
  2. 按 Ctrl+Shift+P（Windows）或 Cmd+Shift+P（macOS）打开命令面板
  3. 输入「Flutter: New Project」并选择
  4. 选择项目目录
  5. 输入项目名称并按回车
  6. 等待项目创建完成，然后按 F5 运行应用

常见问题 ​

1. Android 许可证问题 ​

如果运行 flutter doctor 时出现 Android 许可证问题，运行以下命令并按照提示操作：

bash
flutter doctor --android-licenses

2. iOS 开发环境问题 ​

在 macOS 上，需要安装 Xcode 并接受许可证：

bash
sudo xcodebuild -license

3. 网络问题 ​

如果下载依赖时遇到网络问题，可以配置 Flutter 使用国内镜像：

Windows ​

在环境变量中添加：

  • FLUTTER_STORAGE_BASE_URL = https://storage.flutter-io.cn
  • PUB_HOSTED_URL = https://pub.flutter-io.cn

macOS/Linux ​

在 shell 配置文件中添加：

bash
export FLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn
export PUB_HOSTED_URL=https://pub.flutter-io.cn

升级 Flutter ​

要升级 Flutter 到最新版本，运行：

bash
flutter upgrade

总结 ​

Flutter 的安装和环境配置相对简单，主要步骤包括：

  1. 下载并解压 Flutter SDK
  2. 配置环境变量
  3. 运行 flutter doctor 检查环境
  4. 配置开发工具（Android Studio 或 VS Code）
  5. 创建并运行测试项目验证安装

完成这些步骤后，你就可以开始使用 Flutter 开发跨平台应用了。

基于 VitePress 的本地知识库

Copyright © 2026