
一个高大上的名字 楼主
2015-06-25 13:17
程序猿这条路干久了,就会越发的觉得好习惯的重要性,在这之前,和大部分新手一样,觉得省时省事最重要,但现在慢慢注重这些了,一个好的编码习惯真的会是我们一辈子的财富。在学习的过程中,学会了慢慢积累这些东西,今天就汇总一下,并且以后会持续更新中。
我之前总会有一个坏习惯就是,很多问题没想清楚,就动手敲代码了,结果大部分情况都是无功而返,好点的情况是亡羊补牢,遇到问题就再解决。其实有时候大部分的问题我们细心想一想都可以避免,好的思路可以引导出好的设计,这也就是为什么有设计模式的原因。
这里我贴出谷歌官方风格指南,这里包含了许多语言:C++ Style Guide, Objective-C Style Guide, Java Style
Guide,Python Style Guide, Shell Style Guide, HTML/CSS Style
Guide, JavaScript Style Guide, AngularJS Style Guide, Common Lisp Style Guide, and Vimscript Style Guide等,大家都可以做为参考。
这里我可以引用官方指南:Java代码约定,我们尽可能的遵循官方的代码规范,这里是Android官方给出的一些建议:Android开发者代码风格指南需翻墙,而下面是我整理的一些:
驼峰式命名(大小写交替),常量大写,多个字母间下划线分割;多用常见缩写。
使用Javadoc识别的注释。
局部变量随用随声明(我们要尽量缩小变量的作用域)。
每行的字符不要过长,以100个为限,当然可以在这左右浮动。
缩进用4个空格符来代替Tab。
私有变量的名称我们用m开头。
不要省略大括号{},尤其是在条件判断语句后面,还有就是前大括号不要另起一行,我们遵循Java的规范,如果是C++的话,我们要遵循C++的编码规范,前大括号另起一行。
对于异常,我们的try catch尽可能的少的包含代码。
代码里尽可能不出现中文,最好中文统一写在strings.xml中。
布局文件中的id命名:view缩写_模块名称_view的逻辑名称。
strings.xml中的id命名:activity名称功能模块名称逻辑名称/activity名称逻辑名称/common逻辑名称。
尽可能的将layout中不断重现的style提出通用的style样式,然后放到styles.xml中。
一些服务端处理的逻辑,我们尽可能的放到服务端,让客户端尽量只做数据展示的工作,把其主要精力放在UI和用户体验上面去,而不要去费大量精力去处理繁琐的业务逻辑。
尽可能的使用资源来代替图片,再或者用.9图片处理。
避免使用过多的第三方库,造成客户端包变大。
擅用字符串通配符。
注意listview的性能优化;注意内存泄露问题,尤其在处理图片、线程、游标等资源时。
尽可能少的使用静态变量来作为类之间传值。
资源文件的优化,擅用merge及include,以及viewstub等
资源文件避免嵌套更多的层次,如需RelativeLayout或许是更好地选择。
对于复杂页面的排版可以借用webview组件与html5来结合。
| 名称 | 缩写 |
|---|---|
| icon | ic(主要用在app的图标) |
| color | cl(主要用于颜色值) |
| divider | di(主要用于分隔线,不仅包括Listview中的divider,还包括普通布局中的线) |
| selector | sl(主要用于某一view多种状态,不仅包括Listview中的selector,还包括按钮的selector) |
| average | avg |
| background | bg(主要用于布局和子布局的背景) |
| buffer | buf |
| control | ctrl |
| delete | del |
| document | doc |
| error | err |
| escape | esc |
| increment | inc |
| infomation | info |
| initial | init |
| image | img |
| Internationalization | I18N |
| length | len |
| library | lib |
| message | msg |
| password | pwd |
| position | pos |
| server | srv |
| string | str |
| temp | tmp |
| window | wnd/win |
程序中使用单词缩写原则:不要用缩写,除非该缩写是约定俗成的
| 类型 | 命名 |
|---|---|
| activity | Activity为后缀标识 |
| adapter | Adapter为后缀标识 |
| service | Service为后缀标识 |
| BroadcastReceive | receiver为后缀标识 |
| ContentProvider | 以provider为后缀标识 |
| 基础类 | 以Base为前缀标识 |
| 工具类 | 以Utils或Helper为后缀标识 |
| 封装类 | 以Wrapper为后缀标识 |
| 解析或处理 | 以Paser或Handler为后缀标识 |
| 方法 | 说明 |
|---|---|
| initXX() | 初始化相关方法,使用init为前缀标识,如初始化布局initView() |
| isXX() | checkXX()方法返回值为boolean型的请使用is或check为前缀标识 |
| getXX() | 返回某个值的方法,使用get为前缀标识 |
| processXX() | 对数据进行处理的方法,尽量使用process为前缀标识 |
| displayXX() | 弹出提示框和提示信息,使用display为前缀标识 |
| saveXX() | 与保存数据相关的,使用sav为e前缀标识 |
| resetXX() | 对数据重组的,使用reset前缀标识 |
| clearXX() | 清除数据相关的 |
| removeXXX() | 清除数据相关的 |
| drawXXX() | 绘制数据或效果相关的,使用draw前缀标识 |
| 名称 | 功能描述 |
|---|---|
| btn_xx | 按钮图片使用btn_整体效果 |
| btn_xx_normal | 按钮图片使用btn_正常情况效果 |
| btn_xx_press | 按钮图片使用btn_点击时候效果 |
| bg_XX | 背景图片使用bg功能说明 |
| def_XX | 默认图片使用def功能说明 |
| ic_XX | 图标图片使用icon功能说明 |
| seg_XX | 具有分隔特征的图片使用seg功能说明 |
| sel_XX | 选择图标使用sel功能说明 |
| 类型 | 命名 |
|---|---|
| 整个活动页面 | activity_功能模块 |
| 整个片段页面 | fragment_功能模块 |
| 对话框 | dlg_功能模块 |
| 弹出框 | ppw_功能模块 |
| 列表项 | item_功能模块 |
| 包含项 | include_功能模块 |
| 动画命名 | 写法 |
|---|---|
| fade_in | 淡入 |
| fade_out | 淡出 |
| push_down_in | 从下方推入 |
| push_down_out | 从下方推出 |
| push_left | 推向左方 |
| slide_in_from_top | 从头部滑动进入 |
| zoom_enter | 变形进入 |
| slide_in | 滑动进入 |
| shrink_to_middle | 中间缩小 |
尽量遵循官方命名规范, 多个可按功能划分。如color_功能.xml
| 控件 | 缩写 |
|---|---|
| LinearLayout | ll |
| RelativeLayout | rl |
| TextView | tv |
| Button | btn |
| ImageButton | imgBtn |
| ImageView | iv |
| CheckBox | chk/cb |
| RadioButton | rdoBtn |
| analogClock | anaClk |
| DigtalClock | dgtClk |
| DatePicker | dtPk |
| EditText | edtTxt |
| TimePicker | tmPk |
| ToggleButton | tglBtn |
| ProgressBar | proBar |
| SeekBar | skBar |
| AutoCompleteTextView | autoTxt |
| ZoomControls | zmCtl |
| VideoView | vdoVi |
| WebView | webVi |
| RatingBar | ratBar |
| Tab | tab |
| Spinner | spn |
| Chronometer | cmt |
| ScollView | sclVi |
| TextSwitch | txtSwt |
| ImageSwitch | imgSwt |
| ListView | lv |
| ExpandableList | epdLt |
| MapView | mapVi |
以上仅供参考,部分整理自地址大家有更好的表示方法只要合理均可
先说下苹果官方的代码规范:地址,另外除了前面介绍的谷歌官方指南以外,这里我也推荐GitHub的风格,swift地址还有Objective-C地址,下面是我整理的一些:
关于指针位置的写法,我还是建议和官方保持一致:即*号紧靠变量名 NSString *string。
我们缩进同样使用空格;
每行代码字符长度建议不要超过100个,超过的则换行处理,这个和Android其实是一样的,这个可以在Xcode里面进行设置:通过 “Xcode => Preferences => TextEditing => 勾选Show Page Guide =》输入100 => OK” 。
方法在声明时:在 – 或 + 和返回值之间留1个空格,记得*前的空格是必须的,方法名和第一个参数间则不要留空格,参数过长,则各占一行,这一点对于方法的调用也同样适用,如果参数过多,每个参数应各占一行。在有多行参数的情况下,每行参数前的冒号应对齐。当第一行的函数关键字比其后面行的关键字短时,后面的行应缩进四个空格。保证后续的关键字垂直对齐,而不应该采用冒号对齐的方式。如:
- (id)initWithString:(NSString *)string;
对于类型标识符建议和官方保持一致,之间不留空格。
类名以首字母大写来分割单词,和驼峰有点像。
在应用级别的代码里尽量不使用类名前缀,编写多个应用间的共用代码我们按照官方的使用类名前缀。
getter的方法名不要用get开头,和变量保持一致。
使用权限控制符@public 和@private 应缩进两个空格。
在类型标识符与协议的名之间不应该有空格。此协议使用的规范适用于类的声明、成员变量的声明以及方法的声明,如果申明中包含多个protocal且超出一行时换行,缩进两个空格。
@property与左括号之间留一个空格。@property和@synthesize的缩进级别与@interface或者@implementation的缩进级别相同。@property的声明语句应该紧跟在类的成员变量声明语句块的后面。@synthesize的实现语句应该紧跟在@implementation语句之后。
Category的命名应该包含2-3个字符的前缀,用于说明Category是属于具体的某个工程的,Category的左括号与类名之间应该留一个空格的间隔。
关于方法声明中应尽量单词缩写。
变量名应使用小写开头的驼峰法命名,类成员变量名应该以一个下划线开始,这点和Android不同之处,常量(预定义,枚举,局部常量等)使用小写k开头的驼峰法。
以上可能有不完善的地方,欢迎吐槽指正,后续会慢慢完善。
变量要尽可能的先声明后使用,尽管javascript是一种弱语言,但这样做除了易读外,也可以发现那些被声明为全局的变量。
我们尽可能的减少使用全局变量,声明变量时放在函数头部。
全局变量我们也应该全部大写。
使用{}代替new Object()。使用[]代替new Array()。
使用===和!==操作符会相对好点。==和!=操作符会进行类型强制转换。 特别是, 不要将==用于与错值比较( false,null,undefined,“”,0,NaN)。
谷歌官方给的代码规范还是比较全面的:地址,大部分情况我还是参考这个;
代码规范是我一直比较重视的东西,这里面还有许多没总结到,所以后续文章还会持续更新中。
¥199.00
¥98.00
¥398.00
¥79.00¥179.00