• 微信公众号:美女很有趣。 工作之余,放松一下,关注即送10G+美女照片!

参照腾讯的代码规范以及《数学之美》章节感想

开发技术 开发技术 4小时前 1次浏览

缩进

程序块采用缩进风格编写,缩进只有TAB键;

方法体的开始、类的定义、以及if、for、do、while、switch、case语句中的代码都要采用缩进的方式;

对齐

1程序块的分界符左大括号"{”和右大括号"}"都另起一行,应各独占一行并且位于同一

列,同时与引用它们的语句左对齐;

2对齐只使用TAB键,不使用空格键;

3不允许把多个短语句写在一行中,即一行只写一条语句;

4 if、for、do、while、case、switch、default等语句自占一行。

换行

一行的长度超过80个字符需要换行

换行规则如下:

1在一个逗号后面断开;

2在一个操作符前面断开;

3长表达式要在低优先级操作符处划分新行;

4新行缩进2个TAB.

间隔

1类、方法及相对独立的程序块之间、变量说明之后必须加空行;

2关键字之后要留空格,像if、for、while

等关键字之后应留一个空格再跟左括号”(”,以突出关键字;

3方法名与其左括号“("之间不要留空格,以与关键字区别;

4二元操作符如"="、"+="">="、"<="、"+"、"*"、"%"、"&&"、"|”、"<<","^"等的前后应当加空格;

5一元操作符如“!"、“~”、"++"、“--”等前后不加空格;

6像"[]"、"."这类操作符前后不加空格;

7 for语句中的表达式应该被空格分开

8强制转型后应该跟一个空格

注释

原则:

--对已经不推荐使用的类和方法需要注明@Deprecated,并说明替代的类或者方法;

--对于针对集合、开关的方法,要在方法注释中表明是否多线程安全。

1文件注释

所有的源文件都应该在开头有一个注释,其中列出文件的版权声明、文件名、功能描述以及创建、修改记录

2类或接口注释

采用JavaDoc文档注释,在类、接口定义之前应当对其进行注释,包括类、接口的描述、最新修改者、版本号、参考链接等。

3其它注释(非JavaDoc文档注释)

1单行代码注释一律使用注释界定符"//",

2多行注释使用注释界定符"/*...*/"

命名

基本规则

1使用可以准确说明变量、字段、类、接口、包等完整的英文描述符;

2采用大小写混合,提高名字的可读性;

3采用该领域的术语;尽量少用缩写,但如果一定要使用,当使用公共缩写和习惯缩写等;

4避免使用相似或者仅在大小写上有区别的名字。

包命名

1包名一律小写,少用缩写和长名;

2采用以下规则:

[基本包]。 [项目名]。 [模块名]。 [子模块名]。 . .

3基本包:com.tencent 或com.qq;

4不得将类直接定义在基本包下,所有项目中的类、接口等都应当定义在各自的项目和模块包中;

类或接口命名

类或接口名是个一名词,采用大小写混合的方式,每个单词的首字母大写。尽量使你的类名简洁而富于描述。使用完整单词,避免用缩写词(除非该缩写词被更广泛使用,像URL,HTML) .

变量命名

1采用大小写混合的方式,第一个单词的首字母小写,其后单词的首字母大写;

2变量名不应以下划线或美元符号开头;

3尽量避免单个字符的变量名,除非是一次性的临时变量。临时变量通常被取名为i,j,k,m和n,它们一般用于整型;c,d,e,它们一般用于字符型;

4不采用匈牙利命名法则,对不易清楚识别出该变量类型的变量应使用类型名或类型名缩写作其后缀

5组件或部件变量使用其类型名或类型名缩写作其后缀

6集合类型变量,例如数组和矢量,应采用复数命名或使用表示该集合的名词做后缀

常量命名:全部采用大写,单词间用下划线隔开

方法命名:方法名是一个动词,采用大小写混合的方式,第一个单词的首字母小写,其后单词的首字母大写;取值类可使用get前缀,设值类可使用set前缀,判断类可使用is(has)前缀。

声明

方法声明

1良好的程序设计应该尽可能减小类与类之间耦合,所遵循的经验法则是:尽量限制成员函数的可见性。如果成员函数没必要公有(public),就定义为保护(protected);没必要保护(protected),就定义为私有(private);

2方法定义语法规范:

[可见性]['abstract’] [‘static’] [‘final’] [‘synchronized’][返回值类型]method_name

参数列表)[('throws’)][异常列表]

3声明顺序:

构造方法

静态公共方法

静态私有方法

公共方法

友元方法

受保护方法

私有方法

main方法

4方法参数建议顺序:(被操作者,操作内容,操作标志,其他)

变量声明

1一行一个声明;

2声明局部变量的同时初始化(在变量的初始值依赖于某些先前发生的计算的特殊情况下可以不用同时初始化);

3只在代码块的开始处声明变量,(一个块是指任何被包含在大括号“{“和“}"中间的代码)不要在首次用到该变量时才声明;

4避免声明的局部变量覆盖上一级声明的变量,即不要在内部代码块中声明相同的变量名;

5公共和保护的可见性应当尽量避免,所有的字段都建议置为私有,由获取和设置成员函数(Getter、Setter)访问;

声明顺序

常量

类变量

实例变量:

公有字段

受保护字段

友元字段

私有字段

习惯

1 if、for、do、while等语句的执行语句部分无论多少都要加括号“0”;

2每当一个case顺着往下执行时(因为没有break语句),通常应在break语句的位置添加注释;

3尽量避免在循环中构造和释放对象;

4在使用局部变量的过程,按就近原则处理。不允许定义一个局部变量,然后在很远的地方才使用;

5相同的功能不允许复制成N份代码;

6在处理 String 的时候要尽量使用StringBuffer类。

关于读“《数学之美》第七章-贾里尼克和现代语言处理”的一些感想

在早年生活中作者提到关于贾里尼克对教育的一些观点,小学和中学没必要花太多时间读书,而他们的生活能力、社会经历以及在那时树立起的志向将帮助他们一生。是的,回望我之前的学习生涯,只是为了考试能考高一点,高考能考好一点。关于志向,没有深刻的去想过。贾里尼克的理想在不断改变,但他通过努力走向成功的志向一直没变,他也做到了。

贾里尼克在语音识别领域的成就颇大,他在IBM带领研究队伍,后来队伍的成员都成了了不起的学者。这就是影响力吧。

贾里尼克在老年时期也没闲着,自己生命的最后一刻也是在学术研究上度过的。他建立了CLSP实验室,用自己的影响力和努力让实验室成为了国家级重点实验室。他做到两件大事和两件小事,让实验室成功了。他对自己的学生无私,对晚辈倾囊相助。他说的学习是一辈子的事,他也做到了。

对于当代的大学生,许多人学习的动力相比于那些因为兴趣而学习考上大学的人小了许多,以至于不足够去推动他们学习。我们应该反思,也应该尽早树立起自己的志向。


程序员灯塔
转载请注明原文链接:参照腾讯的代码规范以及《数学之美》章节感想
喜欢 (0)