Skip to content

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 的本地知识库