Flutter从入门到实战-学习笔记

2026 年 4 月 24 日

7580 字

25 分钟

Flutter框架

Flutter 从入门到实战 · Markdown 学习笔记

基于 Flutter从入门到实战.pdf 整理
内容以课程原意为主,重组为更适合复习与查阅的 Markdown 结构。


1. 课程定位

1.1 Flutter 是什么

Flutter 是 Google 开源的 UI 软件开发工具包,用于构建高性能、高质量、接近原生体验的多平台应用。

它的核心价值是:

  • 一套 Dart 代码
  • 面向多个平台开发
  • 追求原生质量的界面和体验

课程中提到的目标平台包括:

  • Android
  • iOS
  • HarmonyOS
  • Web
  • Windows

1.2 为什么要学 Flutter

课程给出的理由主要有三点:

  1. 开发效率高
    一套 Dart 代码可以编译到多个平台。

  2. 市场接受度高
    课程中提到 Flutter 在跨平台框架中有较高采用率。

  3. 企业落地广泛
    已有大量应用采用 Flutter 技术开发。


2. 本课程的学习路径

2.1 课程亮点

本课程强调:

  • 渐进式知识脉络
  • 先语言基础,再框架基础,最后综合案例
  • 渐进式环境配置,降低初学门槛
  • 适配多平台开发需求
  • 结合 AI 编辑器辅助开发

2.2 课程安排

整套内容分为三个部分:

  1. Dart 语言基础
  2. Flutter 组件核心
  3. 综合案例

2.3 Flutter 核心部分包含的主题

根据 PDF 的课程提纲,Flutter 核心模块将覆盖:

  • Flutter 开发环境搭建
  • 工程目录解析
  • 启动文件
  • 页面结构
  • Material 风格体系
  • StatelessWidget / StatefulWidget
  • 生命周期
  • Container / Text / Image
  • SingleChildScrollView / ListView / GridView / CustomScrollView
  • 路由
    • 命名路由
    • 非命名路由
    • 路由传参
    • 路由拦截
    • 404 页面
  • 组件通信
    • 父传子
    • 子传父
    • Provider
    • GetX
  • 网络请求
    • Dio 安装
    • 基础使用
    • 发送请求
    • 拦截器
    • 异常处理
  • 弹层与动画
    • 信息弹窗
    • 确认弹窗
    • 进度条弹窗
    • 动画

2.4 综合案例部分包含的主题

  • 项目搭建
  • 目录结构
  • 基础布局
  • 网络请求封装
  • 数据加载
  • 无限滚动
  • 性能优化
  • 多端适配(安卓 / 苹果 / 鸿蒙 / Web)

3. 适合什么人学习

课程更适合以下人群:

  • 已具备一定编程语言基础
  • 想做跨端应用,但不想分别深入 Android / iOS 原生开发
  • 愿意接受新技术和新生态

课程同时强调:

  • 采用阶梯式学习
  • 避免一开始配置大量环境导致放弃
  • 会根据市场需求持续更新小知识点

4. 环境与工具

4.1 Dart SDK

Dart SDK 是 Dart 语言的官方工具包,用于:

  • 编写程序
  • 编译程序
  • 调试程序
  • 运行程序

PDF 中提到:

  • Windows:可使用安装包安装
  • macOS:可通过 Homebrew 安装
brew install dart-sdk
dart --version

4.2 AI 编辑器 Trae

课程推荐使用 Trae 作为辅助开发工具。

作用包括:

  • 支持多种编程语言
  • 提供 Dart 代码提示
  • 通过 AI 提升编码效率

PDF 中提到的两种 AI 模式:

Tab 模式

  • 开启补全提示后
  • 按 Tab 可直接接受 AI 生成代码

Builder 协作模式

  • 在对话框中输入需求
  • AI 直接生成代码修改
  • 点击接受即可应用改动

5. Dart 基础总览

PDF 的主体内容主要是 Dart 语言基础,覆盖以下知识块:

  • 变量 / 常量
  • 常用数据类型
  • 空安全
  • 运算符
  • 流程控制
  • 函数
  • 类与面向对象
  • 泛型
  • 异步编程

6. Dart 语法注意事项

6.1 基本规则

  • Dart 文件后缀为 .dart
  • Dart 程序入口通常是 main()
  • 大多数语句需要以分号结尾
  • 花括号后通常不加分号

示例:

void main() {
  print('Hello Dart');
}

7. 变量与常量

7.1 var:变量

用于声明值会变化的数据。

var age = 20;
age = 21;

特点:

  • 首次赋值后,类型被推断并固定
  • 之后不能再赋值为其他类型

7.2 const:编译时常量

用于声明编译前就能确定且不可修改的值。

const pi = 3.14159;

特点:

  • 必须是固定值
  • 表达式中不能依赖运行时变量

7.3 final:运行时常量

用于声明运行时确定,但确定后不可再修改的值。

final now = DateTime.now();

特点:

  • 初始化发生在运行时
  • 一旦赋值,不能再次修改

7.4 三者对比

关键字是否可修改确定时机适用场景
var可以运行时普通变量
const不可以编译时固定常量
final不可以运行时初始化后不变的数据

8. 常用数据类型

8.1 String

用于表示文本。

String name = 'Tom';

特点:

  • 支持单引号和双引号
  • 支持拼接
  • 支持模板字符串

模板字符串示例:

String mealTime = '8:00';
String text = '我要在 ${mealTime} 的时候吃早饭';

当模板中是表达式时,推荐使用 ${}。

8.2 数字类型:int / double / num

int count = 10;
double price = 9.9;
num result = 12;

区别:

  • int:整数
  • double:小数
  • num:整数和小数的父类型

课程中强调的赋值关系:

  • double 和 int 不能直接互相赋值
  • num 不能直接赋值给 double
  • double 可以赋值给 num

8.3 bool

用于表示真 / 假。

bool finished = true;

8.4 List

用于存储一组有序数据。

List students = ['学生1', '学生2'];

常用操作:

students.add('学生3');
students.addAll(['学生4', '学生5']);
students.remove('学生1');
students.removeLast();
students.removeRange(0, 2);

常用方法与属性:

  • forEach()
  • every()
  • where()
  • length
  • first
  • last
  • isEmpty

8.5 Map

用于存储键值对。

Map dict = {
  'apple': '苹果',
  'banana': '香蕉',
};

读取 / 赋值:

dict['apple'];
dict['orange'] = '橙子';

常用操作:

  • forEach
  • addAll
  • containsKey
  • remove
  • clear

8.6 dynamic

用于声明动态类型变量。

dynamic value = 'hello';
value = 123;

dynamic 和 var 的区别

关键字类型是否固定是否有编译期检查
dynamic不固定弱化检查
var首次赋值后固定有编译期检查

结论:

  • var 更安全
  • dynamic 更灵活,但更容易隐藏错误

9. 空安全机制

Dart 的空安全用于把很多原本会在运行时发生的空指针问题,提前到编译阶段暴露。

9.1 常见操作符

操作符号作用示例
可空类型?声明变量可以为 nullString? name
安全访问?.对象为 null 时跳过访问user?.name
非空断言!开发者手动断言不为空name!.length
空合并??左侧为空时使用默认值name ?? 'Guest'

9.2 理解重点

  • 默认情况下,非空类型不能赋值为 null
  • 可空类型要显式写 ?
  • ! 只是强行断言,不会真正“修复”空值
  • 写业务代码时优先使用 ?. 和 ??,少用 !

10. 运算符

10.1 算术运算符

运算符作用
+加
-减
*乘
/除
~/整除
%取余

10.2 赋值运算符

运算符作用
=赋值
+=加后赋值
-=减后赋值
*=乘后赋值
/=除后赋值

10.3 比较运算符

比较运算的结果都是 bool。

运算符作用
==相等
!=不等
>大于
>=大于等于
<小于
<=小于等于

10.4 逻辑运算符

运算符作用
&&与
`
!非

使用逻辑运算符时,参与运算的值应为布尔类型。


11. 流程控制

11.1 if

用于条件判断。

常见形式:

  • 单分支
  • 双分支
  • 多分支
if (score >= 90) {
  print('优秀');
} else if (score >= 60) {
  print('及格');
} else {
  print('不及格');
}

11.2 三元运算符

是双分支的简写形式。

String result = isLogin ? '已登录' : '未登录';

11.3 switch / case

当判断条件较多,且本质是“等值判断”时适合使用。

switch (status) {
  case 1:
    print('待支付');
    break;
  case 2:
    print('已支付');
    break;
  default:
    print('未知状态');
}

11.4 while

int i = 0;
while (i < 3) {
  print(i);
  i++;
}

说明:

  • 满足条件时持续执行
  • break:结束整个循环
  • continue:跳过本次,进入下一轮

11.5 for

for (int i = 0; i < 10; i++) {
  print(i);
}

适合:

  • 按次数遍历
  • 遍历列表

12. 函数

12.1 函数的作用

函数是组织代码和复用逻辑的核心单位。

int add(int a, int b) {
  return a + b;
}

12.2 返回值

  • 有返回值:写明确切类型更清晰
  • 无返回值:使用 void
int sum() {
  return 1 + 2;
}

void logInfo() {
  print('hello');
}

课程中提到返回类型可以省略,Dart 会推断为 dynamic,但更推荐显式声明返回类型。

12.3 参数分类

必传参数

特点:

  • 调用时必须传入
  • 不能为空
void printName(String name) {
  print(name);
}

可选位置参数

特点:

  • 放在必传参数后面
  • 使用 [] 包裹
  • 传参按顺序进行
  • 参数少且顺序固定时适合使用
void greet(String name, [String? title = '同学']) {
  print('${title} ${name}');
}

可选命名参数

特点:

  • 放在必传参数后面
  • 使用 {} 包裹
  • 传递时使用 参数名: 值
  • 参数多且想表达含义时更适合
void createUser(String name, {int age = 18, String? city}) {
  print(name);
}

12.4 匿名函数

匿名函数没有函数名,可以赋值给变量。

Function fn = () {
  print('匿名函数');
};

fn();

12.5 箭头函数

当函数体只有一行时可以简写。

int doubleValue(int x) => x * 2;

特点:

  • 写法简洁
  • 可省略 return

13. 类与面向对象

13.1 类的定义

类是面向对象编程的核心,用于描述对象的属性和行为。

class Person {
  String name = '';
  int age = 0;

  void study() {
    print('学习中');
  }
}

实例化与访问:

Person p = Person();
p.name = 'Tom';
p.study();

13.2 构造函数

默认构造函数

class Person {
  String name;
  int age;

  Person({required this.name, required this.age});
}

命名构造函数

class Person {
  String name;
  int age;

  Person({required this.name, required this.age});

  Person.guest()
      : name = 'Guest',
        age = 0;
}

构造函数语法糖

课程提到同名构造函数和命名构造函数都支持 this.xxx 的简写形式,这是 Dart 中非常常见的写法。

13.3 公有属性与私有属性

  • 默认是公有成员
  • 以 _ 开头的是私有成员
class Person {
  String name = 'Tom';
  String _secret = 'private';
}

PDF 的表达重点是:私有属性主要供自身使用,外部文件和类无法直接访问。

13.4 继承

class Animal {
  void eat() {
    print('eat');
  }
}

class Dog extends Animal {
  @override
  void eat() {
    print('dog eat');
  }
}

重点:

  • Dart 是单继承
  • 子类可重写父类方法
  • 子类不会继承父类构造函数
  • 需要时可用 super 调用父类构造函数

13.5 多态

课程中给出的理解是:

  • 同一个操作
  • 作用于不同对象
  • 会产生不同结果

实现方式包括:

  1. 继承 + 方法重写
  2. 抽象类 + 接口实现

抽象类与接口实现

abstract class Pay {
  void submit();
}

class WechatPay implements Pay {
  @override
  void submit() {
    print('微信支付');
  }
}

class AliPay implements Pay {
  @override
  void submit() {
    print('支付宝支付');
  }
}

13.6 Mixins 混入

Mixins 用于在不走传统继承链的前提下,为类添加能力。

mixin SingMixin {
  void sing() {
    print('sing');
  }
}

class Student with SingMixin {}
class Teacher with SingMixin {}

特点:

  • 使用 mixin 定义
  • 使用 with 混入
  • 一个类可混入多个 mixin
  • 后混入的同名方法优先级更高

13.7 泛型

泛型的作用是:

  • 保持灵活性
  • 限定类型范围
  • 提高代码健壮性与可维护性

常见场景:

  • 泛型集合
  • 泛型方法
  • 泛型类

示例:

List<String> names = ['Tom', 'Jerry'];

T firstItem<T>(List<T> items) {
  return items.first;
}

14. Dart 异步编程

14.1 为什么需要异步

课程中强调:

  • Dart 是单线程语言
  • 耗时操作会阻塞执行
  • 因此需要异步机制处理耗时任务

14.2 事件循环

Dart 使用:

  • 单线程
  • 事件循环

来处理异步任务。

两类队列

  1. 微任务队列

    • Future.microtask()
  2. 事件队列

    • Future()
    • Future.delayed()
    • I/O 操作(文件、网络等)

执行顺序可理解为:

  1. 执行同步代码
  2. 执行微任务队列
  3. 执行事件队列
  4. 结束

14.3 Future

Future 表示一个异步操作未来的结果。

状态包括:

  • 等待中
  • 成功完成
  • 失败完成

基础示例:

Future(() {
  return 'done';
}).then((value) {
  print(value);
}).catchError((error) {
  print(error);
});

14.4 Future 链式调用

课程提到:

  • 可通过 .then() 获取成功结果
  • 可通过 .catchError() 获取失败结果
  • 上一个 then 的返回值可传给下一个 then
Future(() => 1)
    .then((value) => value + 1)
    .then((value) => print(value))
    .catchError((error) => print(error));

14.5 async / await

这是更符合顺序思维的异步写法。

Future<void> loadData() async {
  try {
    await Future.delayed(Duration(seconds: 1));
    print('加载完成');
  } catch (error) {
    print(error);
  }
}

理解重点:

  • await 等待 Future 完成
  • async 与 await 通常配套使用
  • 失败处理通常与 try/catch 搭配

15. 一页速查表

15.1 变量与类型

var name = 'Tom';
const pi = 3.14;
final now = DateTime.now();
String text = 'hello';
int count = 1;
double price = 9.9;
bool ok = true;
List items = [1, 2, 3];
Map info = {'name': 'Tom'};
dynamic value = 'x';

15.2 空安全

String? name;
print(name?.length);
print(name ?? 'Guest');

15.3 条件与循环

if (ok) {
  print('yes');
}

for (int i = 0; i < 3; i++) {
  print(i);
}

15.4 函数

int add(int a, int b) => a + b;

15.5 类

class User {
  String name;
  User({required this.name});
}

15.6 异步

Future<void> runTask() async {
  await Future.delayed(Duration(seconds: 1));
}

16. 本 PDF 的核心收获

如果只用几句话概括这份 PDF,重点就是:

  1. 先建立 Flutter 的整体认知:为什么学、学什么、课程如何安排。
  2. 重点夯实 Dart 基础:变量、类型、函数、类、异步是进入 Flutter 前必须掌握的内容。
  3. 为后续 Flutter 实战做准备:组件、路由、状态管理、网络请求、综合案例都建立在 Dart 基础之上。

17. 建议的学习顺序

根据这份 PDF,推荐这样学习:

  1. 先掌握 Dart 基础语法
  2. 重点理解空安全、函数、类、异步
  3. 再进入 Flutter 工程结构与组件体系
  4. 然后学习路由、通信、网络请求
  5. 最后通过综合案例把知识串起来

18. 备注

这份第一份 PDF 当前可提取到的正文内容,主要集中在:

  • 课程导学
  • Dart 语言基础

因此第一部分笔记对 Dart 内容整理更细。下面继续补充第二份 PDF 对应的 Flutter 框架核心。


第二章:Flutter 框架核心

基于 Flutter从入门到实战-Flutter框架.pdf 整理
这一部分重点从“Dart 语言”进入“Flutter 应用结构、组件体系、滚动布局、通信、网络请求与路由管理”。


19. Flutter 开发环境搭建

19.1 安装步骤

课程给出的 Flutter 环境搭建主流程:

  1. 下载 Flutter SDK
  2. 配置环境变量
  3. 执行环境诊断

PDF 特别强调:

  • Flutter SDK 必须放在英文目录下
  • 也可直接从课程资料中获取 SDK

19.2 获取 SDK

一种方式是直接克隆 Flutter 仓库:

git clone https://github.com/flutter/flutter.git

19.3 配置国内镜像与环境变量

macOS

先确认当前 shell:

echo $SHELL

若是 zsh,则配置 ~/.zshrc;若是 bash,则配置 ~/.bash_profile。

示例配置:

export PUB_HOSTED_URL="https://pub.flutter-io.cn"
export FLUTTER_STORAGE_BASE_URL="https://storage.flutter-io.cn"
export PATH="/your/flutter/path/bin:$PATH"

使配置生效:

source ~/.zshrc
# 或
source ~/.bash_profile

Windows

核心思路:

  • 把 flutter/bin 加入系统 Path
  • 再添加两个环境变量:
    • PUB_HOSTED_URL
    • FLUTTER_STORAGE_BASE_URL

19.4 检查环境

flutter --version
flutter doctor -v

这两条命令分别用于:

  • 查看 Flutter 版本
  • 诊断当前开发环境缺失项

20. 创建并运行 Flutter 项目

20.1 创建项目

课程示例先创建 Web 平台项目:

flutter create --platforms web <项目名称>

20.2 打开项目

课程建议:

  • 安装 Chrome 浏览器
  • 使用 Trae 打开项目
  • 进入 lib/main.dart
  • 点击 Run 运行到浏览器

21. Flutter 工程目录结构

课程中对常见目录进行了说明:

路径 / 文件作用
.dart_toolDart 工具生成的缓存文件
.ideaIDE 配置
build构建产物目录
lib主要源码目录
lib/main.dart应用入口
test测试目录
webWeb 平台相关文件
.gitignoreGit 忽略配置
metadataFlutter 项目标识文件
analysis_options.yaml静态分析配置
pubspec.lock依赖锁定文件
pubspec.yaml项目依赖和配置文件
README.md项目说明

21.1 最应该先理解的三个位置

初学时最重要的是:

  1. lib/main.dart:程序入口
  2. pubspec.yaml:依赖与资源配置
  3. lib/:页面、组件、业务逻辑的主要存放位置

22. 启动入口与 Widget 思想

22.1 runApp

runApp 是启动 Flutter 应用的入口函数。

void main() {
  runApp(MyApp());
}

22.2 Widget

课程的核心表达是:

  • Widget 就是组件 / 控件 / 部件
  • Flutter 中万物皆 Widget
  • 页面是由不同 Widget 组合而成的

这意味着:

  • 文本是 Widget
  • 按钮是 Widget
  • 布局容器是 Widget
  • 整个页面本身也是 Widget

22.3 Material 风格

Flutter 内置了 Material 设计体系。

课程中提到 Material 的作用:

  • 提供统一的视觉风格
  • 提供颜色、排版、动画等设计规范
  • 帮助多平台保持一致交互体验

23. 基础骨架组件

23.1 MaterialApp

MaterialApp 用来包裹整个应用,是很多 Flutter 应用的最外层组件。

常见属性:

  • title:应用标题
  • theme:应用主题
  • home:首页组件

示例:

MaterialApp(
  title: 'Flutter Demo',
  theme: ThemeData(),
  home: HomePage(),
)

23.2 Scaffold

Scaffold 是 Material 风格页面的标准骨架。

常见属性:

  • appBar:顶部导航栏
  • body:页面主体
  • bottomNavigationBar:底部导航
  • backgroundColor:背景色
  • floatingActionButton:悬浮按钮

示例:

Scaffold(
  appBar: AppBar(title: Text('首页')),
  body: Center(child: Text('Hello Flutter')),
)

23.3 快速理解关系

通常页面结构是:

runApp(
  MaterialApp(
    home: Scaffold(
      appBar: AppBar(...),
      body: ...,
    ),
  ),
);

即:

  • runApp 启动应用
  • MaterialApp 提供应用级壳子
  • Scaffold 提供页面级骨架

24. StatelessWidget 与 StatefulWidget

24.1 无状态组件 StatelessWidget

适合:

  • 纯展示
  • 不维护内部变化数据
  • 外观只由传入参数决定

写法:

class MyTitle extends StatelessWidget {
  const MyTitle({super.key});

  @override
  Widget build(BuildContext context) {
    return const Text('标题');
  }
}

特点:

  • 结构简单
  • 只需一个类
  • 核心就是实现 build

24.2 有状态组件 StatefulWidget

适合:

  • 有交互
  • 有状态变化
  • 例如计数器、输入框、开关、表单

写法:

class CounterPage extends StatefulWidget {
  const CounterPage({super.key});

  @override
  State<CounterPage> createState() => _CounterPageState();
}

class _CounterPageState extends State<CounterPage> {
  int count = 0;

  @override
  Widget build(BuildContext context) {
    return Text('$count');
  }
}

特点:

  • 由两个类组成
  • 外层 Widget 负责配置
  • 内层 State 负责可变数据与逻辑

24.3 怎么选

组件类型适用场景
StatelessWidget静态展示
StatefulWidget交互与动态更新

24.4 Trae 快速创建组件

课程中提到:

  • statelessW:快速生成无状态组件
  • statefulW:快速生成有状态组件

25. 组件生命周期

25.1 无状态组件生命周期

无状态组件相对简单,核心阶段就是:

  • build()

当组件首次创建,或父组件重建导致它需要刷新时,build 会被调用。

25.2 有状态组件生命周期

课程中给出的主要流程:

创建阶段

  1. createState()
  2. initState()
  3. didChangeDependencies()
  4. build()

更新阶段

  1. didUpdateWidget()
  2. build()

销毁阶段

  1. deactivate()
  2. dispose()

25.3 关键函数含义

initState()

  • 只执行一次
  • 适合做初始化工作
  • 常用于请求初始数据、初始化控制器

didChangeDependencies()

  • initState 后通常会立即执行一次
  • 依赖的 InheritedWidget 更新时也可能再次执行

build()

  • 构建 UI
  • 会执行多次

didUpdateWidget()

  • 父组件配置发生变化时调用
  • 常用于比较新旧参数

dispose()

  • 组件销毁前执行
  • 常用于释放资源,如:
    • TextEditingController
    • AnimationController
    • ScrollController

25.4 记忆口诀

  • 创建:createState -> initState -> didChangeDependencies -> build
  • 更新:didUpdateWidget -> build
  • 销毁:deactivate -> dispose

26. 事件与状态更新

26.1 点击事件 GestureDetector

GestureDetector 是 Flutter 中常用的手势检测组件。

常见用途:

  • 点击
  • 滑动
  • 长按

点击示例:

GestureDetector(
  onTap: () {
    print('clicked');
  },
  child: Container(
    width: 100,
    height: 100,
    color: Colors.blue,
  ),
)

26.2 其他常见可点击组件

课程中还提到:

  • ElevatedButton
  • TextButton
  • OutlinedButton
  • FloatingActionButton
  • InkWell
  • IconButton
  • Switch
  • Checkbox

其中:

  • InkWell 自带 Material 水波纹效果
  • 按钮类组件通常使用 onPressed

26.3 setState

当有状态组件中的数据发生变化,并希望界面同步刷新时,需要调用 setState()。

setState(() {
  count++;
});

作用:

  • 标记当前状态已变化
  • 触发 build() 重新执行
  • 让 UI 与状态保持一致

27. 常见布局组件

27.1 总览

第二章大量内容在讲 Flutter 布局。可以先把它们分成六类:

  1. 基础容器:Container、Center、Align、Padding
  2. 线性布局:Row、Column
  3. 弹性布局:Flex、Expanded、Flexible
  4. 流式布局:Wrap
  5. 层叠布局:Stack、Positioned
  6. 滚动布局:SingleChildScrollView、ListView、GridView、CustomScrollView、PageView

28. 基础容器组件

28.1 Container

Container 是一个非常常用的组合型容器组件。

它可以同时负责:

  • 大小
  • 对齐
  • 内外边距
  • 背景装饰
  • 变换
  • 包裹子组件

常见属性:

  • alignment
  • width / height
  • constraints
  • padding
  • margin
  • color
  • decoration
  • transform
  • child

课程强调:

  • 尺寸优先级通常是:明确宽高 > constraints > 父约束 > 子组件自适应
  • color 与 decoration 通常不要同时使用

示例:

Container(
  width: 120,
  height: 80,
  alignment: Alignment.center,
  margin: const EdgeInsets.all(12),
  padding: const EdgeInsets.all(8),
  decoration: BoxDecoration(
    color: Colors.blue,
    borderRadius: BorderRadius.circular(12),
  ),
  child: const Text('Box'),
)

28.2 Center

Center 用于让子组件在父容器中居中。

特点:

  • 本身不能直接设置宽高
  • 会尽可能占用父组件给它的空间
  • 若要固定大小且居中,通常让 Center 包裹一个有尺寸的子组件
Center(
  child: Container(
    width: 100,
    height: 100,
    color: Colors.red,
  ),
)

28.3 Align

Align 用于精确控制子组件在父容器中的位置。

常见属性:

  • alignment
  • widthFactor
  • heightFactor

示例:

Align(
  alignment: Alignment.topRight,
  child: Icon(Icons.close),
)

理解:

  • Center 可以看作 Align(alignment: Alignment.center) 的特例

28.4 Padding

Padding 只做一件事:给子组件加内边距。

常见写法:

Padding(
  padding: const EdgeInsets.all(16),
  child: Text('Hello'),
)

三种常用设置方式:

  • EdgeInsets.all():四边统一
  • EdgeInsets.only():分别设置
  • EdgeInsets.symmetric():对称设置

结论:

  • 只需要加内边距时,优先用 Padding
  • 需要同时处理背景、尺寸、边框时,再考虑 Container

29. 线性布局:Column 与 Row

29.1 Column

Column 用于垂直排列子组件。

核心属性:

  • mainAxisAlignment:主轴(垂直方向)对齐
  • crossAxisAlignment:交叉轴(水平方向)对齐
  • mainAxisSize
  • children

示例:

Column(
  mainAxisAlignment: MainAxisAlignment.center,
  crossAxisAlignment: CrossAxisAlignment.start,
  children: const [
    Text('用户名'),
    Text('密码'),
  ],
)

常见主轴取值:

  • start
  • end
  • center
  • spaceBetween
  • spaceAround
  • spaceEvenly

常见场景:

  • 登录表单
  • 设置页选项堆叠
  • 卡片信息从上到下排列

注意:

  • Column 本身不滚动
  • 内容过多时应包裹 ListView 或 SingleChildScrollView

29.2 Row

Row 用于水平排列子组件。

核心属性与 Column 类似,只是主轴变成水平方向。

Row(
  mainAxisAlignment: MainAxisAlignment.spaceBetween,
  children: const [
    Icon(Icons.star),
    Text('收藏'),
  ],
)

常见场景:

  • 图标 + 文本
  • 顶部工具栏按钮组
  • 表单中的一行布局

注意:

  • Row 本身也不滚动
  • 内容超出时也会溢出,需要额外处理

30. 弹性布局:Flex / Expanded / Flexible

30.1 Flex

Flex 可以理解为 Row 和 Column 的通用形态。

通过 direction 指定方向:

  • Axis.horizontal
  • Axis.vertical

30.2 Expanded

Expanded 用于强制子组件占满剩余空间。

Row(
  children: [
    Container(width: 100, color: Colors.red),
    Expanded(
      child: Container(color: Colors.blue),
    ),
  ],
)

30.3 Flexible

Flexible 也参与剩余空间分配,但不像 Expanded 那样强制占满。

30.4 区别总结

组件行为
Expanded必须占满分配到的剩余空间
Flexible可以在分配范围内按自身需要布局

课程中的典型场景:

  • 顶部固定
  • 底部固定
  • 中间区域自动撑满剩余空间

31. 流式布局:Wrap

当子组件在一行排不下时,Wrap 会自动换行。

这和 Row / Column / Flex 很不同:后者不会自动换行。

常见属性:

  • direction
  • spacing
  • runSpacing
  • alignment
  • runAlignment

示例:

Wrap(
  spacing: 8,
  runSpacing: 8,
  children: List.generate(
    10,
    (index) => Chip(label: Text('标签$index')),
  ),
)

适合:

  • 标签云
  • 筛选条件
  • 动态数量按钮排列

32. 层叠布局:Stack / Positioned

32.1 Stack

Stack 允许多个子组件在 Z 轴方向叠加显示。

常见属性:

  • alignment
  • fit
  • clipBehavior
  • children

32.2 Positioned

Positioned 是 Stack 的常用搭档,用于精确定位。

Stack(
  children: [
    Image.network('https://example.com/a.png'),
    Positioned(
      right: 8,
      top: 8,
      child: Icon(Icons.favorite, color: Colors.red),
    ),
  ],
)

适合场景:

  • 图片角标
  • 悬浮按钮
  • 水印
  • 弹层

注意:

  • Positioned 必须是 Stack 的直接子组件
  • children 顺序决定层级顺序

33. 文本、图片与输入组件

33.1 Text

Text 是显示文本的基础组件。

常见属性:

  • style
  • textAlign
  • maxLines
  • overflow
Text(
  'Hello Flutter',
  maxLines: 1,
  overflow: TextOverflow.ellipsis,
  style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
)

课程提醒:

  • 长文本建议明确设置 maxLines 和 overflow
  • 公共文本样式可以统一抽离

33.2 Text.rich / TextSpan

同一段文本中有不同样式时,可以用:

  • Text.rich
  • TextSpan

33.3 Image

Flutter 中常见图片加载方式:

  • Image.asset():本地资源图
  • Image.network():网络图
  • Image.file():本地文件
  • Image.memory():内存图

常见属性:

  • width
  • height
  • fit
  • alignment
  • repeat

资源图

使用资源图时,需要先在 pubspec.yaml 配置资源路径。

网络图

课程特别提醒:

  • Android / HarmonyOS / iOS 使用网络图片需要配置网络权限

33.4 TextField

TextField 是文本输入的核心组件。

常见属性:

  • controller
  • decoration
  • style
  • maxLines
  • onChanged
  • onSubmitted
  • obscureText

课程明确强调:

  • TextField 一般放在有状态组件里使用
  • 使用 TextEditingController 管理输入值

简化示例:

class LoginPage extends StatefulWidget {
  const LoginPage({super.key});

  @override
  State<LoginPage> createState() => _LoginPageState();
}

class _LoginPageState extends State<LoginPage> {
  final TextEditingController phoneController = TextEditingController();

  @override
  void dispose() {
    phoneController.dispose();
    super.dispose();
  }

  @override
  Widget build(BuildContext context) {
    return TextField(
      controller: phoneController,
      decoration: const InputDecoration(
        hintText: '请输入账号',
      ),
    );
  }
}

34. 常见滚动组件

34.1 总览

课程将常见滚动组件总结为:

  • SingleChildScrollView
  • ListView
  • GridView
  • CustomScrollView
  • PageView

34.2 SingleChildScrollView

特点:

  • 让单个子组件具备滚动能力
  • 通常里面再放 Column 或 Row
  • 会一次性构建全部内容

适合:

  • 长表单
  • 设置页
  • 内容总量不大,但长度不固定的页面

控制滚动可用 ScrollController:

  • jumpTo(0):回到顶部
  • jumpTo(maxScrollExtent):滚到底部
  • animateTo(...):带动画滚动

注意:

  • 如果内容很多,不建议长期使用它承载大列表,优先考虑 ListView

34.3 ListView

ListView 是最常见的列表滚动组件。

特点:

  • 支持按需渲染
  • 很适合长列表

常见方式:

  1. 默认构造:静态、数量少
  2. ListView.builder:动态长列表,推荐
  3. ListView.separated:带分隔线

示例:

ListView.builder(
  itemCount: 100,
  itemBuilder: (context, index) {
    return ListTile(title: Text('第 $index 项'));
  },
)

34.4 GridView

用于二维网格布局。

常见方式:

  • GridView.count:固定列数
  • GridView.extent:固定子项最大宽度
  • GridView.builder:动态长网格,推荐

课程中提到的关键委托:

  • SliverGridDelegateWithFixedCrossAxisCount
  • SliverGridDelegateWithMaxCrossAxisExtent

34.5 CustomScrollView

CustomScrollView 用于组合多个滚动片段,实现统一滚动效果。

核心思想是使用 Sliver。

常见对应关系:

  • SliverList => 类似 ListView
  • SliverGrid => 类似 GridView
  • SliverAppBar => 可滚动 AppBar
  • SliverPadding
  • SliverToBoxAdapter => 包裹普通 Widget
  • SliverPersistentHeader => 吸顶头部

课程给出的典型场景:

  • 顶部轮播图
  • 中部吸顶分类
  • 底部列表

34.6 PageView

PageView 适合整页切换效果。

适用场景:

  • 引导页
  • 轮播图
  • 横向分页内容

控制器:

  • PageController
  • jumpToPage()
  • animateToPage()

35. 组件通信

课程中总结了多种通信方式:

方式方向适用场景
构造函数传值父 -> 子简单数据传递
回调函数子 -> 父子组件通知父组件
InheritedWidget祖先 -> 后代跨层级共享数据
Provider任意组件间推荐状态管理
EventBus任意组件间全局事件通信
Bloc / Riverpod任意组件间复杂状态管理

35.1 父传子

通过构造函数传值。

课程强调:

  • 子组件接收的属性一般使用 final
  • 如果没有默认值,通常使用 required
  • 有状态组件中,在外层 Widget 接收参数,在 State 中通过 widget.xxx 访问

示例:

class Child extends StatelessWidget {
  final String message;

  const Child({super.key, required this.message});

  @override
  Widget build(BuildContext context) {
    return Text(message);
  }
}

35.2 子传父

通过回调函数。

class Child extends StatelessWidget {
  final ValueChanged<String> onDelete;

  const Child({super.key, required this.onDelete});

  @override
  Widget build(BuildContext context) {
    return TextButton(
      onPressed: () => onDelete('id-1'),
      child: const Text('删除'),
    );
  }
}

父组件接收回调后再更新自己的状态。


36. 网络请求:Dio

36.1 基础使用

课程中推荐 Dio 作为 Flutter 中常用的网络请求工具。

安装:

flutter pub add dio

基础使用:

Dio().get(url).then((response) {
  print(response.data);
}).catchError((error) {
  print(error);
});

课程建议:

  • 页面初始化请求数据,通常放在 initState() 中

36.2 Dio 封装思路

课程给出的封装流程:

  1. 创建工具类
  2. 构造函数中设置基础地址和超时时间
  3. 添加拦截器
  4. 封装统一请求方法
  5. 请求数据并渲染 UI

36.3 拦截器

课程提到了三类拦截器:

  • 请求拦截器
  • 响应拦截器
  • 错误拦截器

并提到:

  • 正常放行使用 handler.next()
  • 拦截失败可使用 handler.reject()

36.4 知识点补充

课程额外提到两个实用点:

  • .. 级联运算符:适合连续对同一个对象赋值
  • cast():把 List 转为 List<具体类型>

36.5 关于 Web 跨域

PDF 中给出了一个通过修改 Flutter 工具源码来关闭浏览器安全策略的方案。这个做法适合教学环境下快速演示,但不建议作为正式项目方案。

更合理的生产实践通常是:

  • 后端正确配置 CORS
  • 使用本地开发代理
  • 避免修改 Flutter SDK 源码

37. 路由管理

37.1 基本概念

Flutter 的路由管理核心依赖:

  • Navigator
  • Route

本质上是通过页面栈实现:

  • 进入新页面
  • 返回上一页
  • 替换当前页
  • 清空历史栈

37.2 基础路由

适合:

  • 页面不多
  • 跳转逻辑简单

方式:

  • 直接在跳转时创建 MaterialPageRoute
Navigator.push(
  context,
  MaterialPageRoute(builder: (_) => DetailPage()),
);

返回:

Navigator.pop(context);

课程提醒:

  • MaterialApp 是路由系统的重要外层组件
  • 一般整个应用只保留一个 MaterialApp

37.3 命名路由

适合:

  • 页面较多
  • 希望统一管理路由表

需要在 MaterialApp 中配置:

  • routes
  • initialRoute

37.4 常用命名路由跳转方法

方法作用
pushNamed入栈进入新页面
pushReplacementNamed替换当前页面
pushNamedAndRemoveUntil跳转并清理历史栈
popAndPushNamed先返回再跳转
popUntil连续返回直到满足条件

很常见的业务含义:

  • 登录成功后进入首页:pushReplacementNamed
  • 退出登录回到登录页并清空历史:pushNamedAndRemoveUntil

37.5 路由传参

命名路由传参

传递:

Navigator.pushNamed(
  context,
  '/detail',
  arguments: {'id': 1},
);

接收:

final args = ModalRoute.of(context)?.settings.arguments;

课程里特别提醒:

  • 命名路由参数在 initState() 中拿不到
  • 可放进 Future.microtask() 后再取

基础路由传参

基础路由更简单,直接通过构造函数传值。

这时参数通常在初始化时就可用。

37.6 动态路由与高级控制

课程提到两个高级入口:

  • onGenerateRoute
  • onUnknownRoute

onGenerateRoute

适合:

  • 根据参数动态决定页面
  • 实现路由拦截
  • 做登录校验

例如:

  • 加入购物车前检查是否登录
  • 未登录则跳到登录页
  • 已登录则跳购物车页

onUnknownRoute

当:

  • 路由表里没有
  • onGenerateRoute 也没处理

就会进入 onUnknownRoute。

最常见用途是:

  • 显示 404 页面

38. 第二章核心收获

第二章的核心不是“会背多少组件名”,而是建立 Flutter 的页面开发思维:

  1. 理解应用壳子:runApp -> MaterialApp -> Scaffold
  2. 理解组件分类:无状态、有状态、布局、滚动、输入、图片、文本
  3. 理解状态更新机制:事件触发 + setState() + build() 重绘
  4. 理解页面组织方式:列表、网格、吸顶、分页、路由跳转
  5. 理解数据流动方式:父子通信、回调、状态管理、网络请求

39. 建议的第二章复习顺序

如果你准备继续学 Flutter,我建议按这个顺序复习第二章:

  1. 先吃透 MaterialApp、Scaffold、Widget
  2. 再区分 StatelessWidget 和 StatefulWidget
  3. 再掌握 setState 和生命周期
  4. 然后练习布局:Container、Row、Column、Wrap、Stack
  5. 再学习滚动:ListView、GridView、CustomScrollView
  6. 接着练习输入框、图片、按钮交互
  7. 最后串起:组件通信 + Dio + 路由
Flutter从入门到实战-学习笔记
https://blog.yagami.top/blog/flutter框架/flutter从入门到实战-学习笔记/
作者
Nekode
发布时间
2026 年 4 月 24 日
许可协议
CC BY-NC-SA 4.0

正在加载评论...

目录

输入关键词开始搜索