基于
Flutter从入门到实战.pdf整理
内容以课程原意为主,重组为更适合复习与查阅的 Markdown 结构。
Flutter 是 Google 开源的 UI 软件开发工具包,用于构建高性能、高质量、接近原生体验的多平台应用。
它的核心价值是:
课程中提到的目标平台包括:
课程给出的理由主要有三点:
开发效率高
一套 Dart 代码可以编译到多个平台。
市场接受度高
课程中提到 Flutter 在跨平台框架中有较高采用率。
企业落地广泛
已有大量应用采用 Flutter 技术开发。
本课程强调:
整套内容分为三个部分:
根据 PDF 的课程提纲,Flutter 核心模块将覆盖:
课程更适合以下人群:
课程同时强调:
Dart SDK 是 Dart 语言的官方工具包,用于:
PDF 中提到:
brew install dart-sdk
dart --version
课程推荐使用 Trae 作为辅助开发工具。
作用包括:
PDF 中提到的两种 AI 模式:
Tab 可直接接受 AI 生成代码PDF 的主体内容主要是 Dart 语言基础,覆盖以下知识块:
.dartmain()示例:
void main() {
print('Hello Dart');
}
var:变量用于声明值会变化的数据。
var age = 20;
age = 21;
特点:
const:编译时常量用于声明编译前就能确定且不可修改的值。
const pi = 3.14159;
特点:
final:运行时常量用于声明运行时确定,但确定后不可再修改的值。
final now = DateTime.now();
特点:
| 关键字 | 是否可修改 | 确定时机 | 适用场景 |
|---|---|---|---|
var | 可以 | 运行时 | 普通变量 |
const | 不可以 | 编译时 | 固定常量 |
final | 不可以 | 运行时 | 初始化后不变的数据 |
String用于表示文本。
String name = 'Tom';
特点:
模板字符串示例:
String mealTime = '8:00';
String text = '我要在 ${mealTime} 的时候吃早饭';
当模板中是表达式时,推荐使用
${}。
int / double / numint count = 10;
double price = 9.9;
num result = 12;
区别:
int:整数double:小数num:整数和小数的父类型课程中强调的赋值关系:
double 和 int 不能直接互相赋值num 不能直接赋值给 doubledouble 可以赋值给 numbool用于表示真 / 假。
bool finished = true;
List用于存储一组有序数据。
List students = ['学生1', '学生2'];
常用操作:
students.add('学生3');
students.addAll(['学生4', '学生5']);
students.remove('学生1');
students.removeLast();
students.removeRange(0, 2);
常用方法与属性:
forEach()every()where()lengthfirstlastisEmptyMap用于存储键值对。
Map dict = {
'apple': '苹果',
'banana': '香蕉',
};
读取 / 赋值:
dict['apple'];
dict['orange'] = '橙子';
常用操作:
forEachaddAllcontainsKeyremovecleardynamic用于声明动态类型变量。
dynamic value = 'hello';
value = 123;
dynamic 和 var 的区别| 关键字 | 类型是否固定 | 是否有编译期检查 |
|---|---|---|
dynamic | 不固定 | 弱化检查 |
var | 首次赋值后固定 | 有编译期检查 |
结论:
var 更安全dynamic 更灵活,但更容易隐藏错误Dart 的空安全用于把很多原本会在运行时发生的空指针问题,提前到编译阶段暴露。
| 操作 | 符号 | 作用 | 示例 |
|---|---|---|---|
| 可空类型 | ? | 声明变量可以为 null | String? name |
| 安全访问 | ?. | 对象为 null 时跳过访问 | user?.name |
| 非空断言 | ! | 开发者手动断言不为空 | name!.length |
| 空合并 | ?? | 左侧为空时使用默认值 | name ?? 'Guest' |
null?! 只是强行断言,不会真正“修复”空值?. 和 ??,少用 !| 运算符 | 作用 |
|---|---|
+ | 加 |
- | 减 |
* | 乘 |
/ | 除 |
~/ | 整除 |
% | 取余 |
| 运算符 | 作用 |
|---|---|
= | 赋值 |
+= | 加后赋值 |
-= | 减后赋值 |
*= | 乘后赋值 |
/= | 除后赋值 |
比较运算的结果都是 bool。
| 运算符 | 作用 |
|---|---|
== | 相等 |
!= | 不等 |
> | 大于 |
>= | 大于等于 |
< | 小于 |
<= | 小于等于 |
| 运算符 | 作用 |
|---|---|
&& | 与 |
| ` | |
! | 非 |
使用逻辑运算符时,参与运算的值应为布尔类型。
if用于条件判断。
常见形式:
if (score >= 90) {
print('优秀');
} else if (score >= 60) {
print('及格');
} else {
print('不及格');
}
是双分支的简写形式。
String result = isLogin ? '已登录' : '未登录';
switch / case当判断条件较多,且本质是“等值判断”时适合使用。
switch (status) {
case 1:
print('待支付');
break;
case 2:
print('已支付');
break;
default:
print('未知状态');
}
whileint i = 0;
while (i < 3) {
print(i);
i++;
}
说明:
break:结束整个循环continue:跳过本次,进入下一轮forfor (int i = 0; i < 10; i++) {
print(i);
}
适合:
函数是组织代码和复用逻辑的核心单位。
int add(int a, int b) {
return a + b;
}
voidint sum() {
return 1 + 2;
}
void logInfo() {
print('hello');
}
课程中提到返回类型可以省略,Dart 会推断为
dynamic,但更推荐显式声明返回类型。
特点:
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);
}
匿名函数没有函数名,可以赋值给变量。
Function fn = () {
print('匿名函数');
};
fn();
当函数体只有一行时可以简写。
int doubleValue(int x) => x * 2;
特点:
return类是面向对象编程的核心,用于描述对象的属性和行为。
class Person {
String name = '';
int age = 0;
void study() {
print('学习中');
}
}
实例化与访问:
Person p = Person();
p.name = 'Tom';
p.study();
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 中非常常见的写法。
_ 开头的是私有成员class Person {
String name = 'Tom';
String _secret = 'private';
}
PDF 的表达重点是:私有属性主要供自身使用,外部文件和类无法直接访问。
class Animal {
void eat() {
print('eat');
}
}
class Dog extends Animal {
@override
void eat() {
print('dog eat');
}
}
重点:
super 调用父类构造函数课程中给出的理解是:
实现方式包括:
abstract class Pay {
void submit();
}
class WechatPay implements Pay {
@override
void submit() {
print('微信支付');
}
}
class AliPay implements Pay {
@override
void submit() {
print('支付宝支付');
}
}
Mixins 用于在不走传统继承链的前提下,为类添加能力。
mixin SingMixin {
void sing() {
print('sing');
}
}
class Student with SingMixin {}
class Teacher with SingMixin {}
特点:
mixin 定义with 混入泛型的作用是:
常见场景:
示例:
List<String> names = ['Tom', 'Jerry'];
T firstItem<T>(List<T> items) {
return items.first;
}
课程中强调:
Dart 使用:
来处理异步任务。
微任务队列
Future.microtask()事件队列
Future()Future.delayed()执行顺序可理解为:
FutureFuture 表示一个异步操作未来的结果。
状态包括:
基础示例:
Future(() {
return 'done';
}).then((value) {
print(value);
}).catchError((error) {
print(error);
});
课程提到:
.then() 获取成功结果.catchError() 获取失败结果then 的返回值可传给下一个 thenFuture(() => 1)
.then((value) => value + 1)
.then((value) => print(value))
.catchError((error) => print(error));
async / await这是更符合顺序思维的异步写法。
Future<void> loadData() async {
try {
await Future.delayed(Duration(seconds: 1));
print('加载完成');
} catch (error) {
print(error);
}
}
理解重点:
await 等待 Future 完成async 与 await 通常配套使用try/catch 搭配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';
String? name;
print(name?.length);
print(name ?? 'Guest');
if (ok) {
print('yes');
}
for (int i = 0; i < 3; i++) {
print(i);
}
int add(int a, int b) => a + b;
class User {
String name;
User({required this.name});
}
Future<void> runTask() async {
await Future.delayed(Duration(seconds: 1));
}
如果只用几句话概括这份 PDF,重点就是:
根据这份 PDF,推荐这样学习:
这份第一份 PDF 当前可提取到的正文内容,主要集中在:
因此第一部分笔记对 Dart 内容整理更细。下面继续补充第二份 PDF 对应的 Flutter 框架核心。
基于
Flutter从入门到实战-Flutter框架.pdf整理
这一部分重点从“Dart 语言”进入“Flutter 应用结构、组件体系、滚动布局、通信、网络请求与路由管理”。
课程给出的 Flutter 环境搭建主流程:
PDF 特别强调:
一种方式是直接克隆 Flutter 仓库:
git clone https://github.com/flutter/flutter.git
先确认当前 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
核心思路:
flutter/bin 加入系统 PathPUB_HOSTED_URLFLUTTER_STORAGE_BASE_URLflutter --version
flutter doctor -v
这两条命令分别用于:
课程示例先创建 Web 平台项目:
flutter create --platforms web <项目名称>
课程建议:
lib/main.dart课程中对常见目录进行了说明:
| 路径 / 文件 | 作用 |
|---|---|
.dart_tool | Dart 工具生成的缓存文件 |
.idea | IDE 配置 |
build | 构建产物目录 |
lib | 主要源码目录 |
lib/main.dart | 应用入口 |
test | 测试目录 |
web | Web 平台相关文件 |
.gitignore | Git 忽略配置 |
metadata | Flutter 项目标识文件 |
analysis_options.yaml | 静态分析配置 |
pubspec.lock | 依赖锁定文件 |
pubspec.yaml | 项目依赖和配置文件 |
README.md | 项目说明 |
初学时最重要的是:
lib/main.dart:程序入口pubspec.yaml:依赖与资源配置lib/:页面、组件、业务逻辑的主要存放位置runApprunApp 是启动 Flutter 应用的入口函数。
void main() {
runApp(MyApp());
}
课程的核心表达是:
这意味着:
Flutter 内置了 Material 设计体系。
课程中提到 Material 的作用:
MaterialAppMaterialApp 用来包裹整个应用,是很多 Flutter 应用的最外层组件。
常见属性:
title:应用标题theme:应用主题home:首页组件示例:
MaterialApp(
title: 'Flutter Demo',
theme: ThemeData(),
home: HomePage(),
)
ScaffoldScaffold 是 Material 风格页面的标准骨架。
常见属性:
appBar:顶部导航栏body:页面主体bottomNavigationBar:底部导航backgroundColor:背景色floatingActionButton:悬浮按钮示例:
Scaffold(
appBar: AppBar(title: Text('首页')),
body: Center(child: Text('Hello Flutter')),
)
通常页面结构是:
runApp(
MaterialApp(
home: Scaffold(
appBar: AppBar(...),
body: ...,
),
),
);
即:
runApp 启动应用MaterialApp 提供应用级壳子Scaffold 提供页面级骨架StatelessWidget适合:
写法:
class MyTitle extends StatelessWidget {
const MyTitle({super.key});
@override
Widget build(BuildContext context) {
return const Text('标题');
}
}
特点:
buildStatefulWidget适合:
写法:
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');
}
}
特点:
| 组件类型 | 适用场景 |
|---|---|
StatelessWidget | 静态展示 |
StatefulWidget | 交互与动态更新 |
课程中提到:
statelessW:快速生成无状态组件statefulW:快速生成有状态组件无状态组件相对简单,核心阶段就是:
build()当组件首次创建,或父组件重建导致它需要刷新时,build 会被调用。
课程中给出的主要流程:
createState()initState()didChangeDependencies()build()didUpdateWidget()build()deactivate()dispose()initState()didChangeDependencies()initState 后通常会立即执行一次InheritedWidget 更新时也可能再次执行build()didUpdateWidget()dispose()TextEditingControllerAnimationControllerScrollControllercreateState -> initState -> didChangeDependencies -> builddidUpdateWidget -> builddeactivate -> disposeGestureDetectorGestureDetector 是 Flutter 中常用的手势检测组件。
常见用途:
点击示例:
GestureDetector(
onTap: () {
print('clicked');
},
child: Container(
width: 100,
height: 100,
color: Colors.blue,
),
)
课程中还提到:
ElevatedButtonTextButtonOutlinedButtonFloatingActionButtonInkWellIconButtonSwitchCheckbox其中:
InkWell 自带 Material 水波纹效果onPressedsetState当有状态组件中的数据发生变化,并希望界面同步刷新时,需要调用 setState()。
setState(() {
count++;
});
作用:
build() 重新执行第二章大量内容在讲 Flutter 布局。可以先把它们分成六类:
Container、Center、Align、PaddingRow、ColumnFlex、Expanded、FlexibleWrapStack、PositionedSingleChildScrollView、ListView、GridView、CustomScrollView、PageViewContainerContainer 是一个非常常用的组合型容器组件。
它可以同时负责:
常见属性:
alignmentwidth / heightconstraintspaddingmargincolordecorationtransformchild课程强调:
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'),
)
CenterCenter 用于让子组件在父容器中居中。
特点:
Center 包裹一个有尺寸的子组件Center(
child: Container(
width: 100,
height: 100,
color: Colors.red,
),
)
AlignAlign 用于精确控制子组件在父容器中的位置。
常见属性:
alignmentwidthFactorheightFactor示例:
Align(
alignment: Alignment.topRight,
child: Icon(Icons.close),
)
理解:
Center 可以看作 Align(alignment: Alignment.center) 的特例PaddingPadding 只做一件事:给子组件加内边距。
常见写法:
Padding(
padding: const EdgeInsets.all(16),
child: Text('Hello'),
)
三种常用设置方式:
EdgeInsets.all():四边统一EdgeInsets.only():分别设置EdgeInsets.symmetric():对称设置结论:
PaddingContainerColumn 与 RowColumnColumn 用于垂直排列子组件。
核心属性:
mainAxisAlignment:主轴(垂直方向)对齐crossAxisAlignment:交叉轴(水平方向)对齐mainAxisSizechildren示例:
Column(
mainAxisAlignment: MainAxisAlignment.center,
crossAxisAlignment: CrossAxisAlignment.start,
children: const [
Text('用户名'),
Text('密码'),
],
)
常见主轴取值:
startendcenterspaceBetweenspaceAroundspaceEvenly常见场景:
注意:
Column 本身不滚动ListView 或 SingleChildScrollViewRowRow 用于水平排列子组件。
核心属性与 Column 类似,只是主轴变成水平方向。
Row(
mainAxisAlignment: MainAxisAlignment.spaceBetween,
children: const [
Icon(Icons.star),
Text('收藏'),
],
)
常见场景:
注意:
Row 本身也不滚动Flex / Expanded / FlexibleFlexFlex 可以理解为 Row 和 Column 的通用形态。
通过 direction 指定方向:
Axis.horizontalAxis.verticalExpandedExpanded 用于强制子组件占满剩余空间。
Row(
children: [
Container(width: 100, color: Colors.red),
Expanded(
child: Container(color: Colors.blue),
),
],
)
FlexibleFlexible 也参与剩余空间分配,但不像 Expanded 那样强制占满。
| 组件 | 行为 |
|---|---|
Expanded | 必须占满分配到的剩余空间 |
Flexible | 可以在分配范围内按自身需要布局 |
课程中的典型场景:
Wrap当子组件在一行排不下时,Wrap 会自动换行。
这和 Row / Column / Flex 很不同:后者不会自动换行。
常见属性:
directionspacingrunSpacingalignmentrunAlignment示例:
Wrap(
spacing: 8,
runSpacing: 8,
children: List.generate(
10,
(index) => Chip(label: Text('标签$index')),
),
)
适合:
Stack / PositionedStackStack 允许多个子组件在 Z 轴方向叠加显示。
常见属性:
alignmentfitclipBehaviorchildrenPositionedPositioned 是 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 顺序决定层级顺序TextText 是显示文本的基础组件。
常见属性:
styletextAlignmaxLinesoverflowText(
'Hello Flutter',
maxLines: 1,
overflow: TextOverflow.ellipsis,
style: TextStyle(fontSize: 18, fontWeight: FontWeight.bold),
)
课程提醒:
maxLines 和 overflowText.rich / TextSpan同一段文本中有不同样式时,可以用:
Text.richTextSpanImageFlutter 中常见图片加载方式:
Image.asset():本地资源图Image.network():网络图Image.file():本地文件Image.memory():内存图常见属性:
widthheightfitalignmentrepeat使用资源图时,需要先在 pubspec.yaml 配置资源路径。
课程特别提醒:
TextFieldTextField 是文本输入的核心组件。
常见属性:
controllerdecorationstylemaxLinesonChangedonSubmittedobscureText课程明确强调:
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: '请输入账号',
),
);
}
}
课程将常见滚动组件总结为:
SingleChildScrollViewListViewGridViewCustomScrollViewPageViewSingleChildScrollView特点:
Column 或 Row适合:
控制滚动可用 ScrollController:
jumpTo(0):回到顶部jumpTo(maxScrollExtent):滚到底部animateTo(...):带动画滚动注意:
ListViewListViewListView 是最常见的列表滚动组件。
特点:
常见方式:
ListView.builder:动态长列表,推荐ListView.separated:带分隔线示例:
ListView.builder(
itemCount: 100,
itemBuilder: (context, index) {
return ListTile(title: Text('第 $index 项'));
},
)
GridView用于二维网格布局。
常见方式:
GridView.count:固定列数GridView.extent:固定子项最大宽度GridView.builder:动态长网格,推荐课程中提到的关键委托:
SliverGridDelegateWithFixedCrossAxisCountSliverGridDelegateWithMaxCrossAxisExtentCustomScrollViewCustomScrollView 用于组合多个滚动片段,实现统一滚动效果。
核心思想是使用 Sliver。
常见对应关系:
SliverList => 类似 ListViewSliverGrid => 类似 GridViewSliverAppBar => 可滚动 AppBarSliverPaddingSliverToBoxAdapter => 包裹普通 WidgetSliverPersistentHeader => 吸顶头部课程给出的典型场景:
PageViewPageView 适合整页切换效果。
适用场景:
控制器:
PageControllerjumpToPage()animateToPage()课程中总结了多种通信方式:
| 方式 | 方向 | 适用场景 |
|---|---|---|
| 构造函数传值 | 父 -> 子 | 简单数据传递 |
| 回调函数 | 子 -> 父 | 子组件通知父组件 |
InheritedWidget | 祖先 -> 后代 | 跨层级共享数据 |
Provider | 任意组件间 | 推荐状态管理 |
EventBus | 任意组件间 | 全局事件通信 |
Bloc / Riverpod | 任意组件间 | 复杂状态管理 |
通过构造函数传值。
课程强调:
finalrequiredwidget.xxx 访问示例:
class Child extends StatelessWidget {
final String message;
const Child({super.key, required this.message});
@override
Widget build(BuildContext context) {
return Text(message);
}
}
通过回调函数。
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('删除'),
);
}
}
父组件接收回调后再更新自己的状态。
课程中推荐 Dio 作为 Flutter 中常用的网络请求工具。
安装:
flutter pub add dio
基础使用:
Dio().get(url).then((response) {
print(response.data);
}).catchError((error) {
print(error);
});
课程建议:
initState() 中课程给出的封装流程:
课程提到了三类拦截器:
并提到:
handler.next()handler.reject()课程额外提到两个实用点:
.. 级联运算符:适合连续对同一个对象赋值cast():把 List 转为 List<具体类型>PDF 中给出了一个通过修改 Flutter 工具源码来关闭浏览器安全策略的方案。这个做法适合教学环境下快速演示,但不建议作为正式项目方案。
更合理的生产实践通常是:
Flutter 的路由管理核心依赖:
NavigatorRoute本质上是通过页面栈实现:
适合:
方式:
MaterialPageRouteNavigator.push(
context,
MaterialPageRoute(builder: (_) => DetailPage()),
);
返回:
Navigator.pop(context);
课程提醒:
MaterialApp 是路由系统的重要外层组件MaterialApp适合:
需要在 MaterialApp 中配置:
routesinitialRoute| 方法 | 作用 |
|---|---|
pushNamed | 入栈进入新页面 |
pushReplacementNamed | 替换当前页面 |
pushNamedAndRemoveUntil | 跳转并清理历史栈 |
popAndPushNamed | 先返回再跳转 |
popUntil | 连续返回直到满足条件 |
很常见的业务含义:
pushReplacementNamedpushNamedAndRemoveUntil传递:
Navigator.pushNamed(
context,
'/detail',
arguments: {'id': 1},
);
接收:
final args = ModalRoute.of(context)?.settings.arguments;
课程里特别提醒:
initState() 中拿不到Future.microtask() 后再取基础路由更简单,直接通过构造函数传值。
这时参数通常在初始化时就可用。
课程提到两个高级入口:
onGenerateRouteonUnknownRouteonGenerateRoute适合:
例如:
onUnknownRoute当:
onGenerateRoute 也没处理就会进入 onUnknownRoute。
最常见用途是:
第二章的核心不是“会背多少组件名”,而是建立 Flutter 的页面开发思维:
runApp -> MaterialApp -> ScaffoldsetState() + build() 重绘如果你准备继续学 Flutter,我建议按这个顺序复习第二章:
MaterialApp、Scaffold、WidgetStatelessWidget 和 StatefulWidgetsetState 和生命周期Container、Row、Column、Wrap、StackListView、GridView、CustomScrollView
正在加载评论...