dart effective 風格和文件

2022-01-14 05:49:17 字數 1832 閱讀 5715

uppercamelcase每個單詞首字母大寫

lowercamelcase 第乙個單詞的首字母小寫

lowercase_with_underscores 全部小寫,字母使用下劃線分割

(1)類、列舉型別、typedef和型別引數應使用 uppercamelcase

(2)擴充套件方法使用 uppercamelcase

(3)庫名、包名、目錄、原始檔使用lowercase_with_underscores

(4)匯入的as使用lowercase_with_underscores

import 'package:angular_components/angular_components' as angular_components;

(5)常量優先使用

const defaulttimeout = 1000;

final urlscheme = regexp('^([a-z]+):');

(6)類成員、頂級函式、變數、引數、命名引數使用lowercamelcase

匯入時的順序

(1)dart自帶庫放最前面

import 'dart:async';

import 'dart:html';

import 'package:bar/bar.dart';

import 'package:foo/foo.dart';

(2)絕對匯入放在相對匯入之前

import 'package:bar/bar.dart';

import 'package:foo/foo.dart';

import 'util.dart';

(3)export放在最後面

import 'src/error.dart';

import 'src/foo_bar.dart';

export 'src/error.dart';

(4)按字母順序排序

import 'package:bar/bar.dart';

import 'package:foo/foo.dart';

import 'foo.dart';

import 'foo/foo.dart';

(1)使用dartfmt格式化**

(2)乙個不要超過80個字元

(3)不是所有的if語句都要使用花括號

if (arg == null) return defaultvalue;

如果不在一行,要使用括號

if (overflowchars !=other.overflowchars) 

雙斜槓 // 注釋的說明,不會進入注釋文件中

文件注釋會使用 dartdoc 解析並生成漂亮的文件

/// 或者 /** */

可以在注釋中使用markdown格式

避免過度使用markdown

避免在markdown中使用html

反引號表示**

/// you can use [codeblockexample] like this:

////// ```

/// var example = codeblockexample();

/// print(example.isitgreat); // "yes."

/// ```

涉及英語的寫作規範,略

視窗風格 視窗類風格

視窗風格 ws border 新建乙個有邊框的視窗 ws caption 新建乙個有邊框 標題欄的視窗。不能和 ws dlgframe 一起用 ws child 新建乙個子視窗,不能和 ws popup 一起用 ws childwindow 和 ws child 風格一樣 ws clipchildr...

python風格規範 Python風格規範

請務必保持 的一致性 如果你正在編輯 花幾分鐘看一下周邊 然後決定風格.如果它們在所有的算術操作符兩邊都使用空格,那麼你也應該這樣做.如果它們的注釋都用標記包圍起來,那麼你的注釋也要這樣.制定風格指南的目的在於讓 有規可循,這樣人們就可以專注於 你在說什麼 而不是 你在怎麼說 我們在這裡給出的是全域...

python風格編碼 Python編碼風格 概述

對於 python 而言,pep 8 已成為大多數專案遵循的風格指南 它給出了乙個高度可讀,視覺友好的編碼風格。每個 python 開發者應該閱讀一下 這裡是為你提取出來的最重要的要點 from pymongo import mongoclient import gridfs,datetime,ti...