Dart 语法简介
Flutter是使用Dart语言开发的。
Dart语言是基于类的纯面向对象语言。
Dart 中的所有东西都是对象，包括数字、函数等，它们都继承自 Object，并且对象的默认值都是 null（包括数字）。
Dart 中类和接口是统一的，类就是接口。
Dart语法和java比较相似，熟悉java开发或者安卓开发会更容易理解Dart语言的语法规范。官宣： Dart语言的语法比JAVA更富有表现力。
总的来说，谷歌的Flutter既然使用Dart语言开发，说明Dart语言在某些方面还是有比其他语言更突出的优势的。
标识符
在 Dart 中标识符有三种风格：
- 大写驼峰：每个单词的第一个字母大写，包括第一个单词。
- 小写驼峰：每个单词的第一个字母大写，除了 第一个单词一直小写，即使第一个单词是缩写。
- 小写加下划线：只使用小写字母，即使是缩写，然后使用下划线_分隔。
包名、文件名使用小写加下线划
一些文件系统是不区分大小写的，所以许多项目要求文件名全小写。使用分隔符使得那种方式下名字仍然可读。使用下划线作为分隔符确保名字仍然是有效的 Dart 标识符。
import 'package:flutter/material.dart';
import 'package:english_words/english_words.dart';
导入别名使用小写加下划线
当导入包时, 如果涉及到别名 as, 一律使用小写+下划线方式
import 'dart:math' as math;
import 'package:english_words/english_words.dart' as ew;
类型名使用大写驼峰
类，枚举，自定义类型和参数类型，应该使用大写驼峰，且不能使用分隔符。
class SliderMenu { ... }
class HttpRequest { ... }
typedef bool Predicate<T>(T value);
甚至包括作为元数据注解的类。
class Foo {
const Foo([arg]);
}
@Foo(anArg)
class A { ... }
@Foo()
class B { ... }
其它标识符使用小写驼峰
类成员，顶级的定义，变量，参数，命名参数使用小写驼峰。
var item;
HttpRequest httpRequest;
void align(bool clearItems) {
// ...
}
常量名称
建议使用小写驼峰式命名
但是你的项目中如果使用大写+下划线分割单词的方式,则可以继续使用这种方式
这里有个小说明:最初dart中采用的大写+下划线方式,但是后来有一些变量需要修改为非const变量,就需要修改为小写驼峰式,后一律使用小写驼峰式
const pi = 3.14;
const defaultTimeout = 1000;
final urlScheme = new RegExp('^([a-z]+):');
class Dice {
static final numberGenerator = new Random();
}
缩写相关
大写首字母缩略词有点难以阅读，并且多个相邻的缩写可能导致模棱两可的名字。例如，一个以HTTPSFTP开始的名字，没有办法判断提及的是HTTPS FTP还是HTTP SFTP。
为了避免这种情况，除了两个字母的首字母缩略词以及缩写词，其它的还是像常规单词那样首字母大写。（两个字母的缩写词，像 ID 和 Mr. 仍然首字母大写。）
HttpConnectionInfo
uiHandler
IOStream
HttpRequest
Id
DB
规定代码的顺序
为了保持文件的整洁，我们规定指令出现的顺序。每个部分应该使用空行隔开。
在其它导入之前导入 “dart:”
import 'dart:async';
import 'dart:html';
import 'package:bar/bar.dart';
import 'package:foo/foo.dart';
在相对导入之前导入 “package:”
import 'package:bar/bar.dart';
import 'package:foo/foo.dart';
import 'util.dart';
在其它导入前导入第三方 “package:”
import 'package:bar/bar.dart';
import 'package:foo/foo.dart';
import 'package:my_package/util.dart';
在所有导入之后的单独部分指定导出
import 'src/error.dart';
import 'src/foo_bar.dart';
export 'src/error.dart';
注释
Dart的文档注释除了有 /** /外 ，还有 /// 。
三斜杠一般单行文档注释使用，多行时每行有个三斜杠效果和/* */ 一样。
- 推荐使用///作为注释。
- Dart的文档注释中可以有markdown的标记语法
- 文件头统一注释模板
/// @desp:
/// @time ${DATE} {USER}
/// 主要用于文档注释来注释成员和类型。
// 主要用于方法体内的注释
///item 点击
void _itemClick() {
_btnClick() {
return () {
//开始请求网络，显示提交框
LcfarmUtil.showSubmitDialog(context);
UserService.passwordVerify(_password, (data) {
//成功回调
//隐藏提交对话框
Navigator.of(context).pop();
LogUtil.v("登录成功");
//进入修改密码页-静态路由表
Navigator.pushNamed(context, Router.passwordUpdate,
arguments: {"phone": "138****8175"});
}, (HttpError error) {
//失败回调
//隐藏提交对话框
Navigator.of(context).pop();
LcfarmUtil.showTipDialog(context, error.message);
});
};
}
约定
- 函数体代码不宜过多，最好在20 - 30行以内 过多改用调用 一个方法中尽量只做一件事
- flutter嵌套层数最好3以内 改为调用
- 入参过多（4个以上），建议封类型
- 函数参数定义要写参数类型
- 加下划线代表private
- 不使用 new 创建（官方）
- if格式定死 条件判断请写好注释 不要嵌套太多的逻辑判断 不能超过3层
if (true) {
// aa
} else {
// bb
}
这样避免了else 悬挂的问题。
if (isWeekDay) {
print('Bike to work!');
} else {
print('Go dancing or read a book!');
}
- 使用dartfmt 程序来格式化代码
- 避免一行的长度超过 80 个字符
