1.2 环境搭建与项目结构

本节将带你完成 Flutter 开发环境的搭建，了解项目的目录结构，并掌握日常开发中最常用的命令行工具。

一、Flutter SDK 安装与配置

1.1 系统要求

1.2 下载 Flutter SDK

方式一：官网下载（推荐）

前往 Flutter 官方网站下载对应平台的 SDK 压缩包：

https://flutter.dev/docs/get-started/install

方式二：通过 Git 克隆（适合持续更新）

gitclone https://github.com/flutter/flutter.git-bstable

1.3 配置环境变量

macOS / Linux

编辑~/.zshrc或~/.bashrc，添加以下内容：

exportPATH="$PATH:/你的安装路径/flutter/bin"

使配置生效：

source~/.zshrc

Windows

1. 打开「系统属性」→「高级」→「环境变量」
2. 在「Path」中新增 Flutter SDK 的bin目录路径，例如：

   C:\flutter\bin

1.4 国内镜像配置（中国用户必配）

由于网络原因，建议配置国内镜像加速：

# 添加到环境变量exportPUB_HOSTED_URL=https://pub.flutter-io.cnexportFLUTTER_STORAGE_BASE_URL=https://storage.flutter-io.cn

1.5 安装 Android / iOS 开发依赖

Android 开发

1. 安装 Android Studio
2. 打开 Android Studio → SDK Manager，安装：
   • Android SDK
   • Android SDK Platform-Tools
   • Android SDK Build-Tools
3. 接受 Android 许可协议：

   flutter doctor --android-licenses

iOS 开发（仅 macOS）

1. 安装 Xcode（App Store）
2. 安装命令行工具：

   sudoxcode-select--install

3. 安装 CocoaPods：

   sudogeminstallcocoapods

二、项目目录结构解析

使用以下命令创建一个新的 Flutter 项目：

flutter create my_appcdmy_app

创建完成后，项目目录结构如下：

my_app/ ├── android/ # Android 原生工程（Java/Kotlin） │ ├── app/ │ │ └── src/main/ │ │ ├── AndroidManifest.xml │ │ └── kotlin/... │ └── build.gradle │ ├── ios/ # iOS 原生工程（Swift/Objective-C） │ ├── Runner/ │ │ ├── AppDelegate.swift │ │ └── Info.plist │ └── Podfile │ ├── lib/ # ⭐ Dart 代码主目录（核心开发目录） │ └── main.dart # 应用程序入口文件 │ ├── test/ # 单元测试与 Widget 测试目录 │ └── widget_test.dart │ ├── web/ # Web 平台支持目录（如已启用） │ ├── linux/ # Linux 平台支持目录 ├── macos/ # macOS 平台支持目录 ├── windows/ # Windows 平台支持目录 │ ├── assets/ # 静态资源目录（图片、字体、JSON 等） │ ├── pubspec.yaml # ⭐ 项目配置文件（依赖、资源声明） ├── pubspec.lock # 锁定依赖版本（自动生成，勿手动修改） ├── analysis_options.yaml # Dart 静态分析规则配置 └── README.md # 项目说明文档

2.1 核心文件详解

lib/main.dart— 程序入口

import'package:flutter/material.dart';voidmain(){runApp(constMyApp());// 启动 Flutter 应用}classMyAppextendsStatelessWidget{constMyApp({super.key});@overrideWidgetbuild(BuildContextcontext){returnMaterialApp(title:'Flutter Demo',home:constMyHomePage(),);}}

pubspec.yaml— 项目配置文件

name:my_app# 项目名称description:A new Flutter project.version:1.0.0+1# 版本号+构建号environment:sdk:'>=3.0.0 <4.0.0'# Dart SDK 版本限制dependencies:flutter:sdk:flutter# 在此添加第三方依赖，例如：# http: ^1.0.0flutter:assets:# 声明静态资源-assets/images/fonts:# 声明自定义字体-family:MyFontfonts:-asset:assets/fonts/MyFont.ttf

2.2 推荐的lib/目录规范结构

随着项目规模扩大，建议按以下方式组织lib/目录：

lib/ ├── main.dart # 入口文件 ├── app.dart # 应用根 Widget │ ├── pages/ # 页面层（各功能页面） │ ├── home/ │ │ ├── home_page.dart │ │ └── home_controller.dart │ └── detail/ │ └── detail_page.dart │ ├── widgets/ # 可复用组件 │ ├── custom_button.dart │ └── loading_widget.dart │ ├── models/ # 数据模型 │ └── user_model.dart │ ├── services/ # 网络请求与业务逻辑 │ └── api_service.dart │ ├── utils/ # 工具函数 │ └── date_utils.dart │ └── constants/ # 常量定义（颜色、字符串等） ├── colors.dart └── strings.dart

三、常用命令与工具

3.1flutter doctor— 环境检测

flutter doctor是配置环境时最重要的诊断命令，它会自动检测开发环境是否配置完整。

flutter doctor

示例输出：

Doctor summary (to see all details, run flutter doctor -v): [✓] Flutter (Channel stable, 3.19.0, on macOS 14.3) [✓] Android toolchain - develop for Android devices (Android SDK version 34.0.0) [✓] Xcode - develop for iOS and macOS (Xcode 15.2) [✓] Chrome - develop for the web [✓] Android Studio (version 2023.1) [✓] VS Code (version 1.87.0) [✓] Connected device (2 available) [✓] Network resources • No issues found!

常用参数：

提示：所有条目显示[✓]才表示环境配置完成。若有[✗]或[!]，按提示修复即可。

3.2flutter run— 运行应用

flutter run

常用参数：

运行时热键（Hot Reload / Hot Restart）：

在flutter run运行状态下，终端支持以下快捷键：

3.3flutter build— 构建应用

flutter build<目标平台>

各平台构建命令：

构建产物路径：

build/ ├── app/outputs/flutter-apk/app-release.apk # Android APK ├── app/outputs/bundle/release/app-release.aab # Android Bundle ├── ios/iphoneos/Runner.app # iOS 产物 └── web/ # Web 产物

3.4 其他常用命令

四、推荐开发工具

小结

👉 下一节：1.3 Dart 语言基础— 了解 Flutter 的编程语言基础