Flex不久前发布了Flex的编码约定与最佳实践文档（原文：http://opensource.adobe.com/wiki/display/flexsdk/Coding+Conventions），标准发布之后引起了广泛的关注和大量的争议。其实很久以来的开发经历使自己养成了一套成型的开发习惯，所以没想做过多改变，对这些东西也就没有多加关注了。直到昨天在CSDN上看到了一篇评价这个文档的文章（找不到链接了。。。），感觉大家对这个文档颇有微辞，于是今天把文档下下来详细的看了下。感觉Adobe这玩意弄的有点仓促，有点为了“标准”而“标准”的感觉，有了很多不必要的条条框框，甚至内容结构都有些问题。不过也有不少值得参考的地方，读文档的时候草草翻译了一下，希望对大家有所帮助（没空间，只能贴了）：
?
?
?
?
?
Flex SDK 编码标准与最佳实践（by 阿顺 http://blog.csdn.net/arshoon，转载请注明出处）
?
?
?
遵循一定编码规范能够使源码看起来前后一致、组织良好、更加专业。
?
本部分内容包括：1. 命名；2. 语言使用 3. 文件组织 4. 格式 5. ASDoc
?
?
?
1. 命名
?
缩写：能避免就避免，代码清晰永远比减少打字重要；但是也要记住一些标准化了的通用的缩写，比如acc(accessiblility),auto(automatic),impl(implementation),info(infomation),num(number),min(minimum),max(maximum),nav(navigation),regexp(regular expression),util(utility)等等。使用缩写时尽量和Flex保持一致；
?
?
?
首字母缩写词：要么全部大写要么全部小写。当首字母缩写词当成一个标志符或者标志符的开始部分，且这个标志符必须以小写字母开始的时候才采用全部小写的方式。
?
?
?
词语边界：标志符多个单词构成的时候，单词首字母大写，或者词语以下划线隔开，比如LayoutManager,object_proxy；当多个首字母缩写词邻接的时候遵循首字母缩写词规范，但是尽量避免。
?
?
?
指定类型的名字：如果你要将某一个类型组合到一个名字中去，那么把在加在最后，比如命名命名一个border图形可以使用：border,borderSkin,borderShape；最好的名字就是类型的小写比如：Button的实例button。
?
?
?
包命名：使用小写字母，之间大写字母隔开，比如controls,listClasses；包名称最好是名词或者动名词，不要用动词、介词、形容词、副词之类。当一个包的作用是实现某一功能的时候最好使用动名词，比如bingding,logging,messaging,printing；支持组件FooBar的最好写作fooBarClasses；
?
?
?
文件名称：对于重要的API文件，文件名称必须和重要的公开API保持一致，但是include文件不一定要遵循此规则；对于包含文件比如用作Styles的，大写字母开始，各个单词隔开，且在最后加上Styles: BorderStyles.as,ModalTrasparencyStyles.as； 对于资源文件小写字母开始，下划线隔开：icon_align_left.png；
?
?
?
命名空间名称：小写字母、下划线隔开：mx_internal,object_proxy
?
?
?
接口名称：字母“I”开始、大写字母间隔：IList,IFocusManager,IUID
?
?
?
类名称：大写字母开始、大写字母间隔：Button， FocusManager；Event子类（FoobarEvent），Error子类（FooBarError），皮肤类(FooBarBackground,FooBarBorder,FooBarIcon...)，utility类（FooBarUtil，不是FooBarUtils，包是复数，类是单数）；
?
?
?
事件名称：小写字母开始、大写字母间隔：move,creationComplete
?
?
?
Style名称：小写字母开始，大写字母间隔：color,fontSize；
?
?
?
字符属性枚举值：auto,filesOnly；
?
?
?
常量命名：全部大写字母，下划线间隔：OFF,DEFAULT_WIDTH，如果常量是一个字符串，那么常量命名和常量值保持一致: <public static const FOO_BAR: String = "fooBar">；
?
?
?
属性名命名：小写字母开始，大写字母间隔： i,width,numChildren；
?
使用i作为选还变量，n作为循环上界；使用j作为循环变量，m作为循环上界：
?
for (var i:int = 0; i < n; i++)
?
{
?
??? for (var j:int = 0; j < m; j++)
?
??? {
?
??????? ...
?
??? }
?
}
?
使用p作为loop循环的变量：
?
for (var p:String in o)
?
{
?
??? ...
?
}
?
如果子类的getter/setter覆盖了基类的getter/setter，但是同时又想继续公开基类的getter/setter，那么这个时候应将基类的属性名前加上“$”作为子类属性名，并且子类的属性名应该标志为final，且除了调用基类getter/setter外不应该做其它的事情：
?
mx_internal final function get $numChildren():int
?
{
?
??? return super.numChildren;
?
}
?
?
?
存储变量命名：getter/setter属性foo所存储的变量应该是_foo（加上下划线）；
?
?
?
方法命名：小写字母开始，每个单词大写字母间隔，应该使用动词：measure(),updateDisplayList()；无参方法应该实现为getter/setter，而不应该是getFooBar(),setFooBar()；当然，如果getFooBar()是一个需要大量计算的慢速度方法的话就应该命名为findFooBar(),calculateFooBar(),determineFooBar()等等，而不是getter；如果子类的某方法覆盖了基类的某方法，但是同时又想继续公开基类的某方法，那么这个时候应将基类的方法名前加上“$”作为子类方法名，并且子类的方法名应该标志为final，且除了调用基类方法外不应该做其它的事情：
?
mx_internal final function $addChild(child:DisplayObject):DisplayObject
?
{
?
??? return super.addChild(child);
?
}
?
?
?
事件处理器命名：在后面加上Handler：mouseDownHandler（）；如果事件处理器是用来处理组件的某一个子组件的事件的话，那么就应该把子组件的名称加到最前面，并且用下划线隔开：textinput_focusInHandler() (textinput的focusin事件的handler)；
?
?
?
参数命名：setter值使用value：public function set label(value:String):void; 事件参数使用event：protected function mouseDownHandler(event:Event):void；
?
?
?
资源包名称：为某一包服务的资源包名称应该和包的名称保持一致；
?
?
?
资源键名称：小写字母，每个单词大写字母隔开；
?
?
?
杂七杂八：避免使用“object”，因为它不明确；“item”是数据项，不是显示对象；renderer是显示数据项的显示对象；“type”是AS3类型，否则使用“kind”；
?
?
?
2. 语言使用
?
这个部分讨论AS3的语言构造，尤其当某一事情有多种表示方法的时候；
?
?
?
编译选项：编译的时候要使用-strict –show-actionscript-warnings（flex-config.xml默认）；
?
?
?
基于属性的API：应该偏向基于属性的API而不是基于方法的API，因为这对于声明示的MXML来说更加有利；
?
?
?
类型声明：尽量为每个变量、参数、返回值等编写注释；参数类型尽量准确，比如循环变量应该是int，而不是Number，更不是Object；鼠标事件处理器的参数应该是MouseEvent而不是Event；如果值可以是undefined的话那么使用“*”，这种情况下可以使用Object代替，null表示undefined；如果声明变量为Array，则应该使用“/*?? */”马上注明数组的成员类型：var a:Array /* of String */ = [];
?
function f(a:Array /* of Number */):Array /* of Object */
?
{
?
??? ...
?
}
?
?
?
保留字：
?
undefined尽量避免使用；
?
int和uint：整数后面不要加小数点，十六进制用0x开始，后面的字母大写；
?
RGB色通常用六个十六进制数字表示；
?
索引值－1表示“没有索引项”；
?
Number：通常表示可以带小数，所以即使变量是整数也应该加上一个小数点和一个零，比如alphaFrom = 0.0; alphaTo = 1.0;但是屏幕坐标值不要这样做；
?
指数计数的时候使用e，比如1.0e12，不要用大写E；
?
String：使用双引号界定字符，即使字符中间包含引号：字符what’up,“Big Boy”?表示为"What''s up,"Big Boy"?"， 而不是’what’s up “Big Boy”?’；
?
Array：使用“[]”， 而不是new Array()，比如[1,2,3]而不是new Array(1,3)；这里在一个数组变量的时候容易出问题，比如一个包含一个值3的数组，如果用new Array(3)，那么表示的是建立了一个三个元素的数组[undefined,undefined,undefined]， 而不是[3]；
?
Object：使用{}， 而不是new Object()；比如{},{a: 1,b: 2,c: 3}；
?
Function：避免使用匿名函数，用类方法或者包方法代替；如果一定要用，那么声明返回值，并且函数体内最后一个语句用分号结尾：function(i:int):void { doIt(i - 1); doIt(i + 1); }
?
RegExp：不要使用正则表达式构造函数创建正则表达式，使用var pattern:RegExp = /d+/g; 而不是var pattern:RegExp = new RegExp("d+","g")；
?
XML和XMLList：直接使用保留字声明，不要使用构造函数。使用var node:XML = <name first="Jane" last="Doe"/>;而不是var node:XML = new XML("<name first="Jane" last="Doe"/>"); XML属性值要使用双引号括起来，不要使用单引号。
?
Class：只有当需要在区分两个导入类的时候才使用类的全名，
?
正确做法（Yes：）：
?
import mx.controls.Button;
?
...
?
var b:Button = new Button();
?
错误做法（No：）：
?
import mx.controls.Button;
?
...
?
var b:Button = new mx.controls.Button();
?
正确做法：
?
import mx.controls.Button;
?
import my.controls.Button;
?
...
?
var b:Button = new mx.controls.Button();
?
?
?
表达式相关：对于通用的操作符（+,-,*,/,&&,||,<,<=,>,>=,==,!=）不要使用不必要的圆括号；其它的优先级不容易记住的可以借助圆括号。
?
?
?
强制类型转换：不要将Boolean变量和true或false比较；显式的将int，uint,Number,String转换为Boolean值，使用if(n !=0 ) 而不是if (n)， 使用if (s != null && s != “”)而不是if (s)，对于对象引用来说可以隐式转换为Boolean值，使用 if (child) 而不是if (child != null)，使用if (!child) 而不是if (child != null)；使用强制类型转换而不是as操作符，仅仅当强制转换可能失败并且你希望失败的时候值为null而不是抛出异常。使用IUIComponent(child).document而不是(child as UIComponnet).document；
?
?
?
比较：以更容易理解的方式书写比较表达式: if (n == 3) // "if n is 3"(Yes)， if (3 == n) // "if 3 is n"（No）；
?
?
?
++ 和 –操作：前缀形式和后缀形式效果一样的时候使用后缀形式，只有当你想在变量在操作之前使用的时候才使用前缀形式；
?
?
?
三元操作符：可以使用三元操作符代替简单的if/else 逻辑，尤其是对null进行判断的时候；
?
return item ? item.label : null (Yes)
?
if (! Item)
return null;
?
return item.label; (No)
?
但是不要使用嵌套的三元操作符；
?
?
?
new：即使构造的类不带参数也要使用圆括号：var b:Button = new Button(); （yes） var b：Button = new Button；（No）；
?
?
?
声明：每一个声明语句都使用分号结尾。
?
?
?
include：使用include 而不是已废弃的#include，和前面一样，每个声明语句以分号结束；使用相对路径而不是绝对路径；
?
?
?
import：导入明确的类，避免使用通配符“*”；
?
?
?
use namespace ：避免使用，非公开名字空间引用使用“::”：
?
Yes：
?
import mx.core.mx_internal;
?
?
?
// Later,in some method...
?
mx_internal::doSomething();?
No：
?
import mx.core.mx_internal;
?
use namespace mx_internal;
?
?
?
// Later,in some method...
?
doSomething();
?
?
?
if：当if/else 分支只有一句声明的时候，不要用{}括起来；
?
Yes：
?
if (flag)
?
doThing1();
?
――――――――――――――――――――――――――――――――――――
?
if (flag)
?
??? doThing1();
?
else
?
doThing2():
?
―――――――――――――――――――――――――――――――――――――
?
No：
?
if (flag)
?
{
?
??? doThing1();
?
}
?
―――――――――――――――――――――――――――――――――――――
?
if (flag)
?
{
?
??? doThing1();
?
}
?
else
?
{
?
??? doThing2();
?
}
?
但是如果有一个分支有多行语句，那么都用{}括起来：
?
Yes：
?
if (flag)
?
{
?
??? doThing1();
?
}
?
else
?
{
?
??? doThing2();
?
??? doThing3();
?
}
?
―――――――――――――――――――――――――――――――――――――――
?
No：
?
if (flag)
?
??? doThing1();
?
else
?
{
?
??? doThing2();
?
??? doThing3();
?
}
?
?
?
对于多个错误检查，使用串行的表达方式，检测错误立即返回，正确值最后返回。不要用嵌套的形式，这样会使整个逻辑看起来很凌乱。
?
Yes：
?
if (!condition1)
?
??? return false;
?
...
?
if (!condition2)
?
??? return false;
?
...
?
if (!condition2)
?
??? return false;
?
...
?
return true;
?
?
?
No：
?
if (condition1)
?
{
?
??? ...
?
??? if (condition2)
?
??? {
?
??????? ...
?
??????? if (condition3)
?
??????? {
?
??????????? ...
?
??????????? return true;
?
??????? }
?
??? }
?
}
?
return false;
?
?
?
for：循环体使用{}括起来，即使只有一行的情况下也是如此。循环上界需要计算的情况下将它存入本地变量，防止多次重复计算。
?
Yes：
?
var n:int = a.length;
?
for (var i:int = 0; i < n; i++)
?
{
?
??? ...
?
}
?
No：
?
for (var i:int = 0; i < a.length; i++)
?
{
?
??? ...
?
}
?
循环变量的声明放入圆括号内，除非这个变量需要多次重复使用。
?
Yes：
?
for (var i:int = 0; i < 3; i++)
?
No：
?
var i:int;
?
for (i = 0; i < 3; i++)
?
{
?
?? ...
?
}
?
?
?
while：循环体使用{}括起来，即使只有一行的情况下也是如此。
?
?
?
do：循环体使用{}括起来，即使只有一行的情况下也是如此。
?
?
?
Switch：每一个case语句都用{}括起来，在{}块里面最后加上return 或者 break语句。如果你想返回值，那么使用return。return后面不必加break。default部分和case部分一样：
?
Yes：
?
switch (n)
?
{
?
??? case 0:
?
??? {
?
??????? foo();
?
??????? break;
?
??? }
?
?
?
??? case 1:
?
??? {
?
??????? bar();
?
??????? return;
?
??? }
?
?
?
??? case 2:
?
??? {
?
??????? baz();
?
??????? return;
?
??? }
?
?
?
??? default:
?
??? {
?
??????? blech();
?
??????? break;
?
??? }
?
}
?
No：
?
switch (n)
?
{
?
??? case 0:
?
??????? foo();
?
??????? break;
?
?
?
??? case 1:
?
??? {
?
??????? bar();
?
??? }
?
??? break;
?
?
?
??? case 2:
?
??????? baz();
?
??????? return;
?
??????? break;
?
?
?
??? default:
?
??????? blech();
?
}
?
?
?
return：返回值不加不必要的圆括号。在函数的中间返回也是可以的。
?
?
?
声明：一行不声明多个变量。
?
Yes：
?
var a:int = 1;
?
var b:int = 2;
?
No：
?
var a:int = 1,b:int = 2;
?
?
?
override：放在第一个。override protected method measure():void（Yes） protected override method measure():void（No）；
?
?
?
存取标志：在用户没有显式声明的情况下存储标志是internal，避免使用默认声明，在必要的地方显式声明。在需要对API进行public或protected声明之前需仔细考虑，因为经过这种类型声明的函数需要建立文档，并且在正式废弃此API之前项目都必须支持此类API。
?
?
?
static：置于存取标志之后。比如public static const MOVE:String =? "move"；
?
?
?
final：置于存取标志之后。将所有enum类声明为final基本属性和方法（那些$开始的）声明为final。
?
?
?
常量：所有常量都必须声明为static，常量的值是一样的，所以声明为实例化常量没有意义。
?
?
?
变量：如果变量需要初始化一个非默认值，那么在声明的时候就赋值，不要放在类的构造函数里面去。
?
?
?
本地变量：在使用的时候声明，而不是放在函数开始的部分。
?
Yes：
?
private function f(i:int,j:int):int
?
{
?
??? var a:int = g(i - 1) + g(i + 1);
?
??? var b:int = g(a - 1) + g(a + 1);
?
??? var c:int? = g(b - 1) + g(b + 1);
?
?
?
??? return (a * b * c) / (a + b + c);
?
}
?
No：
?
private function f(i:int,j:int):int
?
{
?
??? var a:int;
?
??? var b:int;
?
??? var c:int;
?
?
?
??? a = g(i - 1) + g(i + 1);
?
??? b = g(a - 1) + g(a + 1);
?
??? c = g(b - 1) + g(b + 1);
?
?
?
??? return (a * b * c) / (a + b + c);
?
}
?
?
?
本地变量的作用域是整个函数而不是一个块，一个变量在一个函数范围内只需要声明一次。
?
Yes：
?
var i:int;
?
for (i = 0; i < n; i++)
?
{
?
??? ...
?
}
?
?
?
for (i = 0; i < n; i++)
?
{
?
??? ...
?
}
?
No：
?
for (var i:int = 0; i < n; i++)
?
{
?
??? ...
?
}
?
?
?
for (var i:int = 0; i < n; i++)
?
{
?
??? ...
?
}
?
?
?
类：如果类是Object的子类，那么不必要写extends Object；
?
?
?
构造函数：如果类有实例，那么就要编写构造函数，并且在构造函数里显式调用super()。如果构造函数需要对实例属性初始化，那么构造函数的参数名应该和需要初始化的属性名保持一致。
?
Yes：
?
public function MyClass(foo:int,bar:int)
?
{
?
??? this.foo = foo;
?
??? this.bar = bar;
?
}
?
No：
?
public function MyClass(fooVal:int,barVal:int)
?
{
?
??? foo = fooVal;
?
??? bar = barVal;
?
}
?
不要在构造函数里对类实例变量属性进行初始化，应该在声明的部分这样做。如果需要改变父类的属性值，那么这部分工作应该放到构造函数里面。
?
?
?
接口、命名空间、元数据、属性实现：待定；
?
?
?
3. 文件组织
?
在每个as文件的开始部分包含版权信息。2008的开源版权信息如下：
?
///////////////////////////////////////////////////////////////////////////////
?
//
?
//? ADOBE SYSTEMS INCORPORATED
?
//? Copyright 2008 Adobe Systems Incorporated
?
//? All Rights Reserved.
?
//
?
//? NOTICE: Adobe permits you to use,modify,and distribute this file
?
//? in accordance with the terms of the license agreement accompanying it.
?
//
?
///////////////////////////////////////////////////////////////////////////////
?
注意：这个是80字母宽；
?
?
?
package、import 、use namespace声明：待定；
?
?
?
类元数据：按照“块”的形式组织元数据，顺序为：Events,Styles,Effects,Excluded API以及其它元数据。在每个“块”的前面加上一个小的“块”头部，注意，这个头部是40字符宽，且在块名称和//之间有两个空格。在每个块内对元数据按照字母顺序排序，其它的元数据按照元数据标志进行字母排序。
?
//--------------------------------------
?
//? Events
?
//--------------------------------------
?
/
?
**
?
?*? ASDoc comment.
?
?*/
?
[Event
?
?
?
/**
?
?*? ASDoc comment.
?
?*/
?
[Event
?
?
?
//--------------------------------------
?
//? Styles
?
//--------------------------------------
?
?
?
/**
?
?*? ASDoc comment.
?
?*/
?
[Style
?
?
?
/**
?
?*? ASDoc comment.
?
?*/
?
[Style]
?
?
?
//--------------------------------------
?
//? Effects
?
//--------------------------------------
?
?
?
/**
?
?*? ASDoc comment.
?
?*/
?
[Effect
?
?
?
/**
?
?*? ASDoc comment.
?
?*/
?
[Effect]
?
?
?
//--------------------------------------
?
//? Excluded APIs
?
//--------------------------------------
?
?
?
[Exclude(name="horizontalAlign",kind="style")]
?
[Exclude(name="verticalAlign",kind="style")]
?
?
?
//--------------------------------------
?
//? Other metadata
?
//--------------------------------------
?
?
?
[DefaultBindingProperty(source="text",destination="text")]
?
[IconFile("Text.png")]
?
?
?
类声明：待定；
?
?
?
Version.as的包含声明：每个类都应该以相对路径的形式包含core/Version.as，这个文件包含static const VERSION:STRING的声明：
?
include “../core/Version.as”;
?
?
?
实现，类初始化：待定；
?
?
?
类常量：AS3不允许Array和Object类型的常量，但是可以用static var的形式声明(不要用static const)，之所以放到这个部分说明是因为在概念上讲它们仍然是常量。
?
?
?
类资源、类变量：待定；
?
?
?
类属性：在这里声明static类型的getter和setter，按照属性字母排序，每个属性前用属性名分隔，将getter放置在setter之前；
?
?
?
构造函数、变量：待定；
?
?
?
重写属性(override properties)：在这里声明非静态getter和setter，字母排序，属性名隔开，getter在setter之前；
?
?
?
属性：把非静态setter和setter放在这里，字母排序，属性名分隔，getter在setter之前。
?
?
?
重写方法：将重写的非静态方法放在这里。
?
?
?
方法：非静态函数。
?
?
?
重写事件处理器：将重写的事件处理器放到这里。
?
?
?
事件处理器：新的事件处理器。
?
?
?
包外辅助类：待定；
?
?
?
4. 格式：
?
这个部分讨论Flex框架类的应该以何种格式书写。
?
行宽：80字符。优点：小屏幕开发者不必水平滚动；比较工具可以并排放置两个文件窗口；字体投影无需滚动；源码无需经过剪裁或者断行就可以打印；
?
?
?
缩进：4空格；配置你的编辑器插入空格而不是Tab，这样允许其它的程序使用不同的缩进策略而不至于影响显式外观，比如NotPad就是8空格缩进；
?
块分隔符：
?
大“块”分隔符：
?
??? //--------------------------------------------------------------------------
?
??? //
?
??? //? Overridden methods
?
??? //
?
??? //--------------------------------------------------------------------------
?
从4列到80列，文本从8列开始；
?
小“块”分隔符：类里面使用，比如属性之间。形如：
?
??? //----------------------------------
?
??? //? visible
?
??? //----------------------------------
?
从4列到70列，字符8列开始；
?
分隔部分前后放置一个空行；
?
?
?
声明分隔：常量、变量、函数声明由一个空行隔开；
?
/**
?
?*? @private
?
?*? Holds something.
?
?*/
?
var a:Number;
?
?
?
/**
?
?*? @private
?
?*/
?
var b:Number
?
?
?
元数据：Inspectable[a="1",b="2"]（Yes）， Inspectable[a=1 b=2]（No）。
?
?
?
数组索引：中括号前后都不要加空格，a[0] （yes）， a[ 0 ] （no）；
?
?
?
逗号：逗号后面加入一个空格，使用参数、数组、对象等；
?
?
?
数组赋值：左括号后面和右括号前面加入一个空格，[ 1,3 ] (yes)， [1,3],[1,3]（no）；
?
多行复杂数组初始化的时候括号对齐；
?
static var numberNames:Array /* of String */ =
?
[
?
"zero",
?
??? "one",
?
??? "two",
?
??? "three",
?
??? "four",
?
??? "five",
?
??? "six",
?
??? "seven",
?
??? "eight",
?
??? "nine"
?
];
?
?
?
对象赋值：在左花括号后面和右花括号前面加上一个空格， 属性和值之间用的逗号后面加上一个空格；{ a: 1,c: 3 }（yes） {a: 1,c: 3},{a:1,b:2,c:3}（no）；空对象是个例：{} ；需要多行表示的对象保持属性和括号的对齐：
?
private static var TextStyleMap:Object =
?
{
?
??? color: true,
?
??? fontFamily: true,
?
??? fontSize: true,
?
??? fontStyle: true,
?
??? fontWeight: true,
?
??? leading: true,
?
??? marginLeft: true,
?
??? marginRight: true,
?
??? textAlign: true,
?
??? textDecoration: true,
?
??? textIndent: true
?
};
?
?
?
类型声明：不要在变量、参数，或者函数类型的冒号前后加任何空格：
?
Yes:
var n:Number;
?
No:
?
var n : Number;
?
?
?
var n: Number;
?
Yes:
function f(n:Number):void
?
No:
?
function f(n : Number) : void
?
?
?
function f(n: Number): void
?
?
?
操作符和赋值：在赋值操作符、中缀操作符的前后各加一个空格，不要在前缀或者后缀操作符前后加任何空格；
?
?
?
语句行：每个语句一行，块内保持对齐；
?
?
?
函数声明：如果参数需要换行，那么第二行参数和第一行左括号右侧对齐，如果一行放置适当的数目的参数，如果实在无法安排，那么一行放置一个参数。如果第一行一个都没法放，那么将第一个参数放置到第二行，并相对函数声明进行缩进：
?
public function foo(parameter1:Number,parameter2:String,
?
??????????????? parameter3:Boolean):void
?
?
?
public function foo(parameter1:Number,
?
????????????????????? parameter2:String,
?
??????????????? parameter3:Boolean):void
?
?
?
public function aVeryLongFunctionName(
?
??? parameter1:Number,
?
parameter3:Boolean):void
?
?
?
函数调用：f(a,b) （yes）? f(a,b),f( a,b ) （no）；
?
?
?
if表达式：在if后加入一个空格，但是不要在左括号的右侧和右括号的左侧加入任何空格。
?
yes:
?
if (a < b)
?
?
?
no：
?
if(a < b)
?
?
?
if( a < b )
?
?
?
if ( a < b )
?
?
?
for表达式：在for后面加入一个空格，但是不要在左括号的右侧和右括号的左侧加入任何空格。
?
Yes：
?
for (var i:int = 0; i < n; i++)
?
No:
?
for(var i:int = 0; i < n; i++)
?
?
?
for( var i:int = 0; i < n; i++ )
?
?
?
for ( var i:int = 0; i < n; i++ )
?
如果for表达式需要换行，那么和左括号右侧保持对齐：
?
for (var aLongLoopVariableName:int = aLongInitialExpression;
?
??? aLongLoopVariableName < aLongUpperLimit;
?
aLongLoopVariableName++)
?
?
?
switch语句：在switch后面加入一个空格，但是不要在左括号的右侧和右括号的左侧加入任何空格。
?
Yes: switch (n)
No:
?
switch(n)
?
?
?
switch( n )
?
?
?
switch ( n )
?
?
?
5. ASDoc
?
get和set成对出现，只对第一个 get/set函数归档，一般的归档格式如下：
?
/**
?
?*? @private
?
?*? The backing variable for the property.
?
?*/
?
private var _someProp:Foo;
?
?
?
/**
?
?*? Place all comments for the property with the getter which is defined first.
?*? Comments should cover both get and set behavior as appropriate. ? ?*/ ? public function get someProp():Foo ? { ? ? ... ? } ? ? ? /** ? ?*? @private ? ?*/ ? public function set someProp(value:Foo):void ? { ? ? ... ? } ? ASDoc注释适用于类内的结构同时也适用于元数据标签，所以注意你的注释应该适合特定的目标。如果你标志一个属性为绑定，那么你的属性注解应该在get函数之前，而不是绑定标签的前面。 ? Yes： ? [Bindable("somePropChanged")] ? ? ? /** ? ?*? Comments for someProp ? ?*/ ? public function get someProp():Foo ? ? ? No： ? /** ? ?* Comments for someProp ? ?*/ ? [Bindable("somePropChanged")] ? ? ? public function get someProp():Foo
