我做客户端开发有些年头了最近团队要评估一条新业务线一个数字资产行情与交易模拟的App目标平台是安卓和鸿蒙。对比了华为自家的ArkTS、React Native和Flutter之后我们最终把宝押在了Flutter上。今天是这个Flutter学习系列的Day 1主线就是变量与基本类型。别小看这些基础做交易类应用价格精度丢了、订单状态字段拼错了、接口数据没兜底根源全在第一天没把类型系统吃透。这篇文章对有编程基础、想快速把Flutter落到业务项目的开发者最友好。我不会从头讲什么是变量而是把每个类型都映射到一个真实的数字资产交易场景里。看完你大概能明白Dart的强类型和空安全到底给交易逻辑帮了什么忙。1. 为什么我的学习路线是“鸿蒙 Flutter 交易场景”1.1 团队选型时看到的三个方向先交代一下当时的背景。业务侧给的需求很朴素App要同时覆盖安卓和鸿蒙用户开发预算只够养一支客户端团队。这样一来要么维护两套原生代码要么引入跨端框架。原生方案最稳但成本翻倍跨端方案省人但要接受它在某些场景下的妥协。我们当时认真对比了三个方向。第一是华为的ArkTS它和鸿蒙生态绑定得最深系统能力和组件库都是原生的但只能覆盖鸿蒙安卓用户等于完全放弃。第二是React Native社区成熟、招人容易但复杂列表和高频刷新场景下JS桥的性能始终是个隐患做行情页面这种每秒钟刷新几十条数据的业务我心里没底。第三个就是Flutter它自己的自绘渲染引擎Skia新版本逐渐切换到Impeller让界面在两端几乎像素级一致Dart语言对Java、Kotlin背景的团队又很友好基本上半个月就能写出像样的页面。这几个方案最终选谁关键看业务形态。我们的交易模拟App对UI一致性和滚动性能要求很高Flutter在这种场景下优势最明显。至于鸿蒙侧的落地社区一直有适配分支配合OpenHarmony SDK构建一条鸿蒙的产物链路是走得通的。虽然要多踩一些编译环境的坑但总比维护两套UI强。1.2 为什么Day 1从变量与基本类型开始很多朋友学Flutter会直接冲Widget我觉得顺序反了。Flutter的页面是数据驱动渲染的页面上每一个价格标签、每一根K线、每一个订单状态背后都对应着内存里的变量和类型。你连double和int都分不清该在什么时候用后面写行情列表就是在给自己埋雷。做交易类应用时最让人头大的从来不是UI写得不漂亮而是数据模型不稳。同样的字段今天是数字明天后端给你返回字符串同一个订单状态一会儿叫filled一会儿叫FILLED用户没填备注你直接调remark.length运行时就崩了。这些问题追根溯源全部指向对类型系统和空安全的理解不够扎实。所以Day 1我打算用一个章节把变量声明、基本数据类型、数字精度、空安全全部过一遍让后续的学习都建立在一个稳固的地基上。我自己给这个系列定的路线是这样的Day 1变量与基本类型今天Day 2集合和函数Day 3 Widget布局Day 4用Provider做状态管理Day 5网络请求与JSON解析Day 6接一个真实行情接口把列表页做出来。最终收尾时桌上会有一个能看行情、能加自选、能模拟下单的小App。1.3 这个项目的最终形态先画个轮廓这个项目的最终形态不复杂一个行情列表页展示多个交易对的实时价格和涨跌幅一个详情页展示K线一个自选列表一个模拟下单面板。你在自选页点“加自选”这个交易对就进一个Set集合你在模拟下单面板点“买入”系统就生成一笔订单订单状态从“提交中”一路流转到“已成交”或“已取消”。这些听上去都是业务逻辑但写代码的时候你会发现整个骨架全是变量和类型在支撑。自选集合是Set 订单是Order类订单状态是enum枚举价格是整数类型涨跌幅是double。所以Day 1学变量和类型不是学一堆语法糖而是直接给后面所有页面和逻辑打地基。2. Day 1环境准备先把一个Flutter项目跑起来2.1 Windows下安装Flutter SDK的要点在自己电脑上装Flutter我建议选一个没有中文和空格、也不在系统盘的路径。Windows上我习惯放在D:\flutter解压完把D:\flutter\bin加到系统环境变量PATH里。macOS开发者同理路径选好就行。国内网络环境下有两个环境变量特别重要PUB_HOSTED_URL和FLUTTER_STORAGE_BASE_URL。把它们配置为国内镜像地址以后拉取Dart包和Flutter引擎的时候会快很多。这个配置真的不能省我第一次偷懒没配后面pub get卡了半小时直接原地心态崩掉。配置好环境变量打开命令行执行flutter doctor。这个命令会检查Flutter SDK、Dart、Android工具链和连接设备的状态。看到“Android toolchain”那一项是绿色的再装一个Android Studio并且在Android Studio的插件市场里安装Flutter和Dart插件基础环境就算齐了。2.2 用flutter create创建交易项目环境就绪之后创建项目是一行命令的事flutter create --org com.example trade_app cd trade_app flutter run这里我建议第一天先用安卓模拟器跑通这条链路不要一上来就折腾鸿蒙目标。鸿蒙侧的构建要引入社区适配的Flutter分支还要配置OpenHarmony SDK整体比安卓麻烦不少适合单独开一篇专门讲。先把基础链路跑通你才有心情学变量和类型不然光编译环境就够劝退了。2.3 第一个页面把变量用起来我写的第一个页面极其简单一个Text控件显示一段拼接出来的字符串。但就是这段代码把声明变量、类型推断、字符串插值全部串起来了void main() { runApp(const TradeApp()); } class TradeApp extends StatelessWidget { const TradeApp({super.key}); override Widget build(BuildContext context) { String symbol BTCUSDT; double price 1234.56; bool isRising true; return MaterialApp( home: Scaffold( body: Center( child: Text($symbol $price ${isRising ? 上涨 : 下跌}), ), ), ); } }这里有两个点你可以感受一下。一个是Dart的字符串插值$symbol直接把变量值嵌进字符串里比Java里用加号拼接舒服太多。另一个是类型推断我都写的是var也可以但明确写出String、double、bool读代码的人一眼就知道这个变量承载什么数据在团队协作时比省几个字符划算得多。3. 变量与基本类型Dart类型系统的核心用法3.1 var、final、const到底怎么选先聊var。Dart里的var并不是JavaScript里那种“随便什么类型都能装”的弱类型它只是让编译器根据第一次赋的值来自动推断。var price 1234.5之后price的类型就固定为double后面想给它赋值字符串编译器直接报错。这种推断机制既保留了写代码的简洁又不会丢掉类型检查的好处。final和const都表示变量一旦赋值就不能再改但两者有本质区别。const的值在编译期就必须确定比如手续费率0.001、订单状态里“待支付”这个字符串这类写死不变的东西用const。final的值则要到运行时才生成比如一笔新订单的ID要等用户点了“下单”那一刻用时间戳生成这种场景用final。我在项目里写变量的习惯是能const就const不能const就优先final只有这个变量确实需要在运行过程中被多次修改时才用var或普通类型声明。这样写代码的好处很实在变量拥有不变性之后读代码的人不需要花心思追踪它哪里被改过逻辑边界清晰很多。尤其是在异步和并发场景下不可变变量的心智负担远低于可变变量。// var自动推断类型 var currentPrice 1234.5; // 推断为double // currentPrice 上涨; // 这行会编译报错 // final运行时确定赋值后不可变 final orderId DateTime.now().millisecondsSinceEpoch.toString(); // const编译期常量 const feeRate 0.001; // 手续费率0.1% // 直接写类型 int volume 100; String symbol BTCUSDT; bool isFrozen false;3.2 基本类型全家桶与交易场景一一对应Dart里日常开发用到的基本类型并不复杂我把它们和交易场景的对应关系整理成了表格类型说明在交易App里的典型用法int整数订单数量、成交量、价格的最小单位整数double浮点数涨跌幅、展示用价格、资金费率numint和double的父类接口返回不确定是整数还是浮点时先用它接住String字符串交易对符号、订单ID、后端状态码bool布尔值是否自选、是否可交易、是否冻结List有序集合行情列表、订单列表、自选列表Map键值对接口返回的原始JSON数据结构Set无序去重集合自选交易对集合天然去重enum枚举订单状态、买卖方向每一类都不是抽象的。行情列表就是List 接口返回的JSON是MapString, dynamic自选功能用Set 存交易对符号买卖方向用enum OrderSide { buy, sell }。你不需要死记表格写代码时自然就会用到。3.3 浮点精度价格为什么不能用double直接算这是交易系统里最经典的坑我觉得应该在第一天就讲透。double在计算机底层是二进制浮点数它没法精确表示所有十进制小数。最经典的例子0.1 0.2算出来是0.30000000000000004。做普通页面这误差无所谓但资金计算一旦累计多次误差账面就对不上了。行业里的通行做法是把金额换算成最小精度单位的整数再存储和计算。比如价格精确到小数点后两位1234.56就存成123456。所有计算都在整数上进行只在展示那一刻除以10的精度次方并格式化成字符串。import dart:math; String formatPrice(int raw, int precision) { final divisor pow(10, precision).toDouble(); return (raw / divisor).toStringAsFixed(precision); }如果后端下发的是字符串形式的“1234.56”我建议先用double.tryParse解析再乘以精度倍数转成整数不要在字符串和double之间反复横跳。这跟“先存整数、展示再除”的原则是一致的也是数字资产交易系统里最基本的稳健性保障。3.4 空安全也就是“这个字段可能没有”Dart 2.12起默认开启null safety这条特性对这个行业帮助太大了。普通类型默认不允许为null想允许为空就在类型后面加一个问号比如String? remark。这样编译器会在你使用remark的时候强制你去思考它为空时怎么办用交易场景举例。自选列表里每个交易对可能带备注也可能不带这个字段就应该声明为String?。展示的时候用remark ?? 暂无备注给一个兜底文案。订单列表里一笔订单还没成交时成交价就是null字段就应该声明为int? fillerPrice。你写代码时如果忘了处理空值编译器会直接报错提醒你而不是等用户真的遇到一笔未成交订单时闪退。还有两个符号简单说一下。叹号表示非空断言String name remark!意思是“我确定这里有值直接解包”。写起来很爽但一旦运行起来发现是null立刻崩溃。另一个是late表示延迟初始化late String cache; 声明时不赋值第一次访问前必须赋值。这两个工具适合在某些明确的场景下用但新手阶段尽量少用多写显式的空判断更稳。3.5 类型转换is判断与as强转Dart是强类型语言但接口返回到App里时经常是dynamic或Map类型所以类型转换逃不掉。我的原则是接收数据时宽松使用数据时严格。先把不确定的数据转成确定类型再进入业务逻辑。is用来做类型判断返回布尔值as用来做强制转换转不了就抛异常。解析JSON时更稳的写法是先用is判断类型再决定怎么转换final data json[price]; if (data is String) { final price double.parse(data); } else if (data is int) { final price data.toDouble(); }这样写的好处是无论后端把价格传成字符串还是数字代码都能兼容。宁可多写几行判断也不要让一行as强转把整个页面炸掉。4. 数字资产交易逻辑中的数据建模实战4.1 用类型定义一条行情Ticker行情列表是交易App最核心的页面它背后是无数条Ticker数据。我的Ticker模型长这样class Ticker { final String symbol; // 交易对例如 BTCUSDT final int lastPrice; // 最新价整数存储精度为2 final double changePercent; // 涨跌幅展示用 final int volume; // 24小时成交量 final bool isFrozen; // 是否被禁止交易 const Ticker({ required this.symbol, required this.lastPrice, required this.changePercent, required this.volume, required this.isFrozen, }); }所有字段都用final修饰因为一条行情数据一旦创建出来就不应该再被修改。行情刷新时我们创建一条新的Ticker对象去替换旧对象而不是在旧对象上改字段。这正是Day 1学final的实战价值告诉编译器这条数据是不可变的你尽管放心引用不用担心它被别的地方偷偷改掉。4.2 订单状态用枚举管理状态流转订单状态是交易系统里最典型的“状态机”。一笔模拟订单从生成到结束大致会经历“提交中”、“委托中”、“已成交”、“已取消”或者“已拒绝”这几个状态。用枚举来定义它们是最自然的选择enum OrderStatus { submitting, open, filled, cancelled, rejected } enum OrderSide { buy, sell } class Order { final String orderId; final OrderSide side; final OrderStatus status; final int price; final int quantity; const Order({ required this.orderId, required this.side, required this.status, required this.price, required this.quantity, }); }为什么不用字符串直接存状态因为编译器查不出拼写错误。你写status OrderStatus.filled永远不会打错但写成status filied这种字符串时只能等运行到那一行才暴露问题严重的时候会让整个订单流全部错乱。从后端接口拿到的状态往往是字符串我的习惯是统一写一个解析函数遇到不认识的字符串就兜底成rejected。宁可让这笔订单显示为“已拒绝”也不能让它的状态悬空让用户看到一个不知道发生了什么的状态。这就是类型系统加上一点防御性编程给交易逻辑上的第一道保险。4.3 从JSON到实体类类型安全的最后防线真实开发中Flutter拿到的是后端返回的MapString, dynamic。写fromJson时我的核心原则是每个字段解析都做兜底绝不让一个异常字段崩掉整个列表。factory Ticker.fromJson(MapString, dynamic json) { return Ticker( symbol: json[symbol]?.toString() ?? , lastPrice: int.tryParse(json[lastPrice]?.toString() ?? 0) ?? 0, changePercent: double.tryParse(json[changePercent]?.toString() ?? 0) ?? 0, volume: int.tryParse(json[volume]?.toString() ?? 0) ?? 0, isFrozen: json[isFrozen] true, ); }核心思路就一句话无论后端字段缺失、类型传错还是传入null这行代码都会给一个默认值而不是抛异常。??是空值合并运算符左边有值用左边没值用右边。配合上一章的空安全这一套组合拳基本能挡住95%的JSON解析崩溃。4.4 用集合类型处理自选和订单筛选等模型定义好了你会发现集合类型在业务逻辑里非常顺手final allOrders Order[]; final buyOrders allOrders.where((order) order.side OrderSide.buy).toList(); final symbols allOrders.map((order) order.symbol).toSet();第一行是空订单列表第二行筛出所有买单第三行取出所有涉及过的交易对并把它们放进一个Set去重。List、Map、Set在这一小段代码里全部用上了没有任何一个类型是多余的。你写到这里会明显感觉到Dart的强类型不是学术概念它直接决定你写集合API时编译器会不会帮你拦住低级错误。5. 变量作用域与Flutter组件状态5.1 全局、成员、局部变量的可见边界作用域决定了一个变量在哪些代码里能被访问到。Dart里主要分三层全局变量顶层变量、类成员变量、方法局部变量。我的经验是局部变量能用就用局部生命周期短不会跨文件产生隐式耦合成员变量只在所属类内部生效是承载状态的主力全局变量尽量少写它是bug温床改起来牵一发动全身。这里分享一个我踩过的坑项目早期图省事把用户登录信息存成了一个全局变量。结果某个页面在异步回调里改了它另一个页面读到的已经是新值界面却还显示旧状态排查了半天。后来规定所有全局级数据都必须走状态管理问题才消停。类型系统管得住类型管不住作用域作用域全靠开发者自觉。5.2 Flutter组件里变量放在哪里很讲究Flutter的组件分为StatelessWidget和StatefulWidget它们的变量使用规则完全不同。StatelessWidget是配置型组件一旦构建出来就不该被修改所以它的字段必须用final修饰。StatefulWidget则不同它的State类里可以维护可变变量但这些变量要承担一个特殊职责UI依赖它们。class TradeScreen extends StatefulWidget { const TradeScreen({super.key}); override StateTradeScreen createState() _TradeScreenState(); } class _TradeScreenState extends StateTradeScreen { bool _isLoading true; ListTicker _tickers []; void _refresh() { setState(() { _isLoading false; _tickers [..._tickers]; }); } }这段代码的关键点在于_isLoading和_tickers是成员变量。修改它们时必须通过setState通知框架“我变了请重绘页面”。如果你把它们写成局部变量setState发出去的信号根本触碰不到它们UI永远不知道数据已经变了。很多新手改了数据页面不刷新八成是变量作用域放错了位置。5.3 先留个引子跨组件共享变量交给Provider成员变量只在State类的内部可见。那如果两个页面都要读写同一个自选列表呢这就涉及跨组件状态管理了。Day 1不展开但我想留个引子Flutter生态里有一个官方推荐的方案叫Provider它的本质就是把一个共享状态对象挂在Widget树的根部让所有子组件都能读到、并订阅它的变化。届时你会发现今天学的变量作用域和final这些规则是理解状态管理的基础。变量放哪里、谁能改、怎么通知别人本质都是作用域问题。6. Flutter新手常见报错与问题排查6.1 flutter新建项目后跑不起来先查这三件事新手最崩溃的往往不是语法而是环境问题。“新建项目跑不起来”这个现象我把最常见的原因和处理方向整理成了速查表现象可能原因处理方向flutter doctor提示找不到设备模拟器没开或真机USB调试没开创建Android模拟器或打开开发者模式里的USB调试首次编译卡很久Gradle一直下载Gradle依赖下载慢检查环境变量镜像配置把Gradle仓库地址也换成国内镜像刚创建项目就报SDK版本错误本机缺少对应Android SDK组件执行flutter doctor --android-licenses并补齐SDK项目跑起来但页面空白闪退空安全或类型转换抛异常打开控制台看Dart堆栈回头检查null相关代码这四条按顺序排查能解决80%的“新建项目跑不起来”。记住一个习惯任何Flutter构建问题第一步永远是flutter doctor它会告诉你环境哪里不对。6.2 新版Flutter的Gradle插件报错说明最近创建的新项目里你可能会在第一次构建时看到一段报错开头大概是这样You are applying Flutters main Gradle plugin imperatively using the apply method, which is no longer supported...意思是新版Flutter把Gradle插件改成了插件式声明旧版本里在build.gradle手动apply的方式被废弃了。解决方式很简单把手动apply的代码删掉改用settings.gradle里的plugins块来声明plugins { id dev.flutter.flutter-plugin-loader version 1.0.0 id com.android.application version 7.3.0 apply false }改完同步一下Gradle就能恢复。遇到Gradle相关报错我的经验是先翻当前Flutter版本对应的模板不要直接搜索三个月前的旧答案Flutter迭代太快很多方案都已经过时了。6.3 Unhandled Exception日志重点在Dart堆栈控制台里最常见的崩溃日志长这样E/flutter: [ERROR:flutter/runtime/dart_vm_initializer.cc(41)] Unhandled Exception: type Null is not a subtype of type String注意flutter里这行C层的错误只是一个“搬运工”真正有价值的线索在后面的Dart堆栈。看到type Null is not a subtype of type String这种信息第一反应是空安全出问题某个null值被强转成了String如果看到type String is not a subtype of type int那就是JSON字段类型和模型声明不匹配回到上一章的fromJson兜底方案里找答案。定位方法也有套路点堆栈里第一行Dart代码跳转到出错源文件在可疑位置加print或者断点逐行缩小范围。别被那一长串十六进制地址吓到它只是工具链的噪音真正要关心的永远是后面几行。6.4 真机调试设备列表为空怎么处理Windows上插了安卓真机但flutter devices里什么都看不到这问题90%出在驱动和连接上。先换一根能传数据的数据线很多线只能充电不能传数据。再装手机对应的USB驱动然后打开开发者模式里的USB调试。连上后如果还是识别不了拔掉重插或者关掉开发者模式再打开一次。如果这些做完了flutter devices还是空的就用adb kill-server然后adb start-server重启一下adb服务。这类问题几乎没有高深原理就是耐心把链路查一遍线材、驱动、权限、服务总有一个环节在偷懒。Day 1学下来我最直观的感受是变量和基本类型绝不是“入门之后就忘掉”的知识Dart的类型系统越严格越逼着你在写第一行代码前就把数据结构想清楚。我做完Ticker模型和订单状态模型之后明显感觉到只要类型定得好交易逻辑就已经成功了一半。你也别光看这篇文章建议照着代码把Ticker类写一遍再故意改几个字段的类型看看编译会报什么错。这种“亲手踩一遍类型错误”的体验比读十遍博客都管用。明天Day 2接着搞集合和函数到时候见。