跨平台开发 / 系统课时
用 AspectRatio 保持内容比例
用 AspectRatio 保持内容比例
图片、视频封面和商品卡片常常要在不同屏幕宽度下保持稳定形状。AspectRatio 的作用不是指定一个固定尺寸,而是在父级约束允许的范围内,为子组件选择一个满足宽高比的尺寸,从而避免内容随着可用宽度变化而被拉成长条或压成窄块。
学习目标
- 理解
AspectRatio如何在父级约束内计算尺寸 - 能用
aspectRatio为媒体区域保持稳定宽高比 - 知道在紧约束下为什么比例可能无法生效
AspectRatio 解决的核心问题
AspectRatio 接收一个 double 类型的 aspectRatio,计算规则是“宽度 ÷ 高度”。例如 16:9 应写成 16 / 9,1:1 写成 1。它会先查看父组件给出的约束,再尝试选出一个既合法又尽量符合该比例的尺寸。
这意味着它和固定 width、height 的思路不同:固定尺寸强调“我要这么大”,而 AspectRatio 强调“无论最终多大,都尽量保持这个形状”。

用 16:9 比例创建媒体区域
下面的完整 Flutter 示例让卡片宽度随页面变化,但图片区域始终保持 16:9。AspectRatio 负责尺寸关系,内部的 Container 只负责内容和视觉样式。
import 'package:flutter/material.dart';
void main() {
runApp(const AspectRatioDemo());
}
class AspectRatioDemo extends StatelessWidget {
const AspectRatioDemo({super.key});
@override
Widget build(BuildContext context) {
return MaterialApp(
home: Scaffold(
appBar: AppBar(title: const Text('AspectRatio Demo')),
body: Padding(
padding: const EdgeInsets.all(16),
child: Center(
child: SizedBox(
width: 360,
child: AspectRatio(
aspectRatio: 16 / 9,
child: Container(
color: Colors.blue.shade100,
alignment: Alignment.center,
child: const Text('16:9 media area'),
),
),
),
),
),
),
);
}
}预期结果:
页面中央出现一个宽 360 logical pixels 的浅蓝色矩形区域,高度约为 202.5 logical pixels;改变外层可用宽度后,区域高度会随之变化,但宽高比保持 16:9。这里不需要手工计算并写死高度,因为 AspectRatio 会根据实际宽度推导高度。对于响应式页面,这种写法比同时维护两个尺寸值更稳定。
理解父级约束的优先级
AspectRatio 仍然必须服从 Flutter 的约束传递规则。如果父级已经把宽度和高度都固定死,例如外层 SizedBox(width: 200, height: 200),那么子级没有重新选择尺寸的空间。即使内部写了 aspectRatio: 16 / 9,最终外部占用区域仍可能是 200×200。
因此排查“比例为什么没生效”时,先看父级是否给出了紧约束,而不是先怀疑 aspectRatio 数值。只固定一边通常更适合 AspectRatio 发挥作用,例如只限制最大宽度,让另一边由比例推导。
什么时候适合使用
图片缩略图、视频播放器占位、相机预览壳、商品封面和固定比例卡片都适合用 AspectRatio。这些场景的共同点是:尺寸可以响应父级变化,但内容形状必须稳定。
如果业务要求的是绝对固定尺寸,直接用 SizedBox 更清楚;如果需要根据父级实时尺寸执行更复杂的分支布局,则应考虑 LayoutBuilder。AspectRatio 最适合“只需要保持比例,不需要自己管理完整尺寸计算”的场景。