Flutter 代码开发规范

更新日期: 2019-05-25阅读: 2.3k标签: 规范

Flutter 代码开发规范文档 仅做参考


标识符三种类型
大驼峰
类、枚举、typedef和类型参数

    class SliderMenu { ... }
          
    class HttpRequest { ... }
          
    typedef Predicate = bool Function<T>(T value);

包括用于元数据注释的类

    class Foo {
        const Foo([arg]);
      }
      
      @Foo(anArg)
      class A { ... }
      
      @Foo()
      class B { ... }


使用小写加下划线来命名库和源文件

    library peg_parser.source_scanner;
      
    import 'file_system.dart';
    import 'slider_menu.dart';


不推荐如下写法:

    library pegparser.SourceScanner;
    import 'file-system.dart';
    import 'SliderMenu.dart';


使用小写加下划线来命名导入前缀

    import 'dart:math' as math;
    import 'package:angular_components/angular_components'
          as angular_components;
    import 'package:js/js.dart' as js;


不推荐如下写法:

    import 'dart:math' as Math;
    import 'package:angular_components/angular_components'
      as angularComponents;
    import 'package:js/js.dart' as JS;


使用小驼峰法命名其他标识符

     var item;
      
     HttpRequest httpRequest;
      
     void align(bool clearItems) {
        // ...
     }


优先使用小驼峰法作为常量命名

    const pi = 3.14;
    const defaultTimeout = 1000;
    final urlScheme = RegExp('^([a-z]+):');
      
    class Dice {
        static final numberGenerator = Random();
    }

不推荐如下写法:

    const PI = 3.14;
    const DefaultTimeout = 1000;
    final URL_SCHEME = RegExp('^([a-z]+):');
      
    class Dice {
      static final NUMBER_GENERATOR = Random();
    }

不使用前缀字母
因为Dart可以告诉您声明的类型、范围、可变性和其他属性,所以没有理由将这些属性编码为标识符名称。

defaultTimeout

不推荐如下写法:

kDefaultTimeout

排序
为了使你的文件前言保持整洁,我们有规定的命令,指示应该出现在其中。每个“部分”应该用空行分隔。

在其他引入之前引入所需的dart库

    import 'dart:async';
    import 'dart:html';
      
    import 'package:bar/bar.dart';
    import 'package:foo/foo.dart';

在相对引入之前先引入在包中的库

    import 'package:bar/bar.dart';
    import 'package:foo/foo.dart';
      
    import 'util.dart';

第三方包的导入先于其他包

    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';

不推荐如下写法:

    import 'src/error.dart';
    export 'src/error.dart';
    import 'src/foo_bar.dart';

所有流控制结构,请使用大括号
这样做可以避免悬浮的else问题

    if (isWeekDay) {
        print('Bike to work!');
    } else {
        print('Go dancing or read a book!');
    }

一个if语句没有else子句,其中整个if语句和then主体都适合一行。在这种情况下,如果你喜欢的话,你可以去掉大括号

if (arg == null) return defaultValue;

如果流程体超出了一行需要分划请使用大括号:

    if (overflowChars != other.overflowChars) {
      return overflowChars < other.overflowChars;
    }

不推荐如下写法:

    if (overflowChars != other.overflowChars)
        return overflowChars < other.overflowChars;

注释
要像句子一样格式化

除非是区分大小写的标识符,否则第一个单词要大写。以句号结尾(或“!”或“?”)。对于所有的注释都是如此:doc注释、内联内容,甚至TODOs。即使是一个句子片段。

    greet(name) {
      // Assume we have a valid name.
      print('Hi, $name!');
    }

不推荐如下写法:

    greet(name) {
      /* Assume we have a valid name. */
      print('Hi, $name!');
    }

可以使用块注释(/…/)临时注释掉一段代码,但是所有其他注释都应该使用//

Doc注释
使用///文档注释来记录成员和类型。
使用doc注释而不是常规注释,可以让dartdoc找到并生成文档。

    /// The number of characters in this chunk when unsplit.
    int get length => ...

考虑为私有api编写文档注释
Doc注释并不仅仅针对库的公共API的外部使用者。它们还有助于理解从库的其他部分调用的私有成员

以简短的、以用户为中心的描述开始你的文档注释,以句号结尾。

    /// Deletes the file at [path] from the file system.
    void delete(String path) {
      ...
    }

不推荐如下写法:

    /// Depending on the state of the file system and the user's permissions,
    /// certain operations may or may not be possible. If there is no file at
    /// [path] or it can't be accessed, this function throws either [IOError]
    /// or [PermissionError], respectively. Otherwise, this deletes the file.
    void delete(String path) {
      ...
    }

字符串的使用
优先使用模板字符串

'Hello, $name! You are ${year - birth} years old.';

集合
尽可能使用集合字面量
如果要创建一个不可增长的列表,或者其他一些自定义集合类型,那么无论如何,都要使用构造函数

    var points = [];
    var addresses = {};
    var lines = <Lines>[];

不推荐如下写法:

    var points = List();
    var addresses = Map();

不要使用.length查看集合是否为空

    if (lunchBox.isEmpty) return 'so hungry...';
    if (words.isNotEmpty) return words.join(' ');

不推荐如下写法:

    if (lunchBox.length == 0) return 'so hungry...';
    if (!words.isEmpty) return words.join(' ');

考虑使用高阶方法转换序列
如果有一个集合,并且希望从中生成一个新的修改后的集合,那么使用.map()、.where()和Iterable上的其他方便的方法通常更短,也更具有声明性

    var aquaticNames = animals
          .where((animal) => animal.isAquatic)
          .map((animal) => animal.name);

避免使用带有函数字面量的Iterable.forEach()
在Dart中,如果你想遍历一个序列,惯用的方法是使用循环。

    for (var person in people) {
      ...
    }

不推荐如下写法:

    people.forEach((person) {
        ...
    });

不要使用List.from(),除非打算更改结果的类型
给定一个迭代,有两种明显的方法可以生成包含相同元素的新列表

    var copy1 = iterable.toList();
    var copy2 = List.from(iterable);

明显的区别是第一个比较短。重要的区别是第一个保留了原始对象的类型参数

    // Creates a List<int>:
    var iterable = [1, 2, 3];
    
    // Prints "List<int>":
    print(iterable.toList().runtimeType);
    // Creates a List<int>:
    var iterable = [1, 2, 3];
    
    // Prints "List<dynamic>":
    print(List.from(iterable).runtimeType);

参数的使用
使用=将命名参数与其默认值分割开
由于遗留原因,Dart均允许“:”和“=”作为指定参数的默认值分隔符。为了与可选的位置参数保持一致,使用“=”。

void insert(Object item, {int at = 0}) { ... }

不推荐如下写法:

void insert(Object item, {int at: 0}) { ... }

如果参数是可选的,但没有给它一个默认值,则语言隐式地使用null作为默认值,因此不需要编写它

    void error([String message]) {
      stderr.write(message ?? '\n');
    }

不推荐如下写法:

    void error([String message = null]) {
      stderr.write(message ?? '\n');
    }

变量
不要显式地将变量初始化为空
在Dart中,未显式初始化的变量或字段自动被初始化为null。不要多余赋值null

    int _nextId;
      
      class LazyId {
        int _id;
      
        int get id {
          if (_nextId == null) _nextId = 0;
          if (_id == null) _id = _nextId++;
      
          return _id;
        }
      }

不推荐如下写法:

    int _nextId = null;
      
      class LazyId {
        int _id = null;
      
        int get id {
          if (_nextId == null) _nextId = 0;
          if (_id == null) _id = _nextId++;
      
          return _id;
        }
      }

避免储存你能计算的东西
在设计类时,您通常希望将多个视图公开到相同的底层状态。通常你会看到在构造函数中计算所有视图的代码,然后存储它们:

    class Circle {
        num radius;
        num area;
        num circumference;
      
        Circle(num radius)
            : radius = radius,
              area = pi * radius * radius,
              circumference = pi * 2.0 * radius;
      }

如上代码问题:

浪费内存
缓存的问题是无效——如何知道何时缓存过期需要重新计算?

推荐的写法如下:

    class Circle {
        num radius;
      
        Circle(this.radius);
      
        num get area => pi * radius * radius;
        num get circumference => pi * 2.0 * radius;
      }

类成员
不要把不必要地将字段包装在getter和setter中
不推荐如下写法:

    class Box {
        var _contents;
        get contents => _contents;
        set contents(value) {
          _contents = value;
        }
      }

优先使用final字段来创建只读属性
尤其对于 StatelessWidget

在不需要的时候不要用this
不推荐如下写法:

    class Box {
        var value;
        
        void clear() {
          this.update(null);
        }
        
        void update(value) {
          this.value = value;
        }
      }

推荐如下写法:

    class Box {
        var value;
      
        void clear() {
          update(null);
        }
      
        void update(value) {
          this.value = value;
        }
      }

构造函数
尽可能使用初始化的形式
不推荐如下写法:

     class Point {
        num x, y;
        Point(num x, num y) {
          this.x = x;
          this.y = y;
        }
      }

推荐如下写法:

    class Point {
      num x, y;
      Point(this.x, this.y);
    }

不要使用new
Dart2使new 关键字可选
推荐写法:

    Widget build(BuildContext context) {
        return Row(
          children: [
            RaisedButton(
              child: Text('Increment'),
            ),
            Text('Click!'),
          ],
        );
      }

不推荐如下写法:

    Widget build(BuildContext context) {
        return new Row(
          children: [
            new RaisedButton(
              child: new Text('Increment'),
            ),
            new Text('Click!'),
          ],
        );
      }

异步
优先使用async/await代替原始的futures
async/await语法提高了可读性,允许你在异步代码中使用所有Dart控制流结构。

    Future<int> countActivePlayers(String teamName) async {
        try {
          var team = await downloadTeam(teamName);
          if (team == null) return 0;
      
          var players = await team.roster;
          return players.where((player) => player.isActive).length;
        } catch (e) {
          log.error(e);
          return 0;
        }
    }

当异步没有任何用处时,不要使用它
如果可以在不改变函数行为的情况下省略异步,那么就这样做:

    Future afterTwoThings(Future first, Future second) {
        return Future.wait([first, second]);
    }

不推荐写法:

    Future afterTwoThings(Future first, Future second) async {
        return Future.wait([first, second]);
    }

链接: https://fly63.com/article/detial/3887

web开发,前后分离接口规范

目前我们现在用的前后端分离模式属于第一阶段,下一阶段可以在前端工程化方面,对技术框架的选择、前端模块化重用方面,可多做考量。也就是要迎来“==前端为主的 MV* 时代==”。

js中箭头函数的编码规范,如何更好的使用箭头函数

当您必须使用匿名函数,请使用箭头函数表示法,它创建了一个在 this 上下文中执行的函数的版本,这通常是你想要的,而且这样的写法更为简洁。如果你有一个相当复杂的函数,你或许可以把逻辑部分转移到一个声明函数上。

用standard来管理JavaScript 代码规范

standard是一个开源的JS代码规范库,制定了所谓standard(标准)的JS代码规范,配合编辑器插件可以实时检查代码规范以及语法错误,通过执行命令检查代码规范以及语法错误,自动修复(可以直接修复的)不合规范的代码,使其符合规范

Web 前端开发代码规范(基础)

对于一个多人团队来说,制定一个统一的规范是必要的,因为个性化的东西无法产生良好的聚合效果,规范化可以提高编码工作效率,使代码保持统一的风格,以便于代码整合和后期维护。

Node.js的模块加载机制(CommonJS规范)

为了编写可维护的代码,我们把很多函数分组,分别放到不同的文件里,这样,每个文件包含的代码就相对较少,很多编程语言都采用这种组织代码的方式。在Node环境中,一个.js文件就称之为一个模块(module)

web前端js中ES6的规范写法

引号的使用,单引号优先(如果不是引号嵌套,不要使用双引号)、空格的使用问题:(关键字后 符号后 排版 函数 赋值符号= )等、不写没有使用过的变量,如果定义了一个变量,后来一直没有参与过运算,那么不应该定义这个变量...

编码规范_html代码规范化编写

嵌套的节点应该缩进;在属性上,使用双引号,不要使用单引号;属性名全小写,用中划线做分隔符;不要在自动闭合标签结尾处使用斜线(HTML5 规范 指出他们是可选的);不要忽略可选的关闭标签;

CommonJS 规范中的 module、module.exports 区别

CommonJS规范规定,每个模块内部,module变量代表当前模块。这个变量是一个对象,它的exports属性(即module.exports)是对外的接口。加载某个模块,其实是加载该模块的module.exports属性。module.exports属性表示当前模块对外输出的接口

W3C 代码标准规范

W3C通过设立领域(Domains)和标准计划(Activities)来组织W3C的标准活动,围绕每个标准计划,会设立相关的W3C工作组织(包括工作组、社区组、商务组等)。W3C会根据产业界的标准需求调整Domains和Activity的设置及相关的工作组设置。

css3代码书写规范

不要使用 @import 与 <link> 标签相比,@import 指令要慢很多,不光增加了额外的请求次数,还会导致不可预料的问题。CSS有些属性是可以缩写的,比如padding,margin,font等等,这样精简代码同时又能提高用户的阅读体验。

点击更多...

内容以共享、参考、研究为目的,不存在任何商业目的。其版权属原作者所有,如有侵权或违规,请与小编联系!情况属实本人将予以删除!