434
社区成员
发帖
与我相关
我的任务
分享使用 4 个空格做为一个缩进层级,不允许使用 2 个空格 或 tab 字符。
switch 下的 case 和 default 必须增加一个缩进层级。
二元运算符两侧必须有一个空格,一元运算符与操作对象之间不允许有空格。
用作代码块起始的左花括号 { 前必须有一个空格。
if / else / for / while / function / switch / do / try / catch / finally 关键字后,必须有一个空格。
在对象创建时,属性中的 : 之后必须有空格,: 之前不允许有空格。
函数声明、具名函数表达式、函数调用中,函数名和 ( 之间不允许有空格。
, 和 ; 前不允许有空格。如果不位于行尾,, 和 ; 后必须跟一个空格。
在函数调用、函数声明、括号表达式、属性访问、if / for / while / switch / catch 等语句中,() 和 [] 内紧贴括号部分不允许有空格。
行尾不得有多余的空格。
每个独立语句结束后必须换行。
每行不得超过 120 个字符。
在函数声明、函数表达式、函数调用、对象创建、数组创建、for 语句等场景中,不允许在 , 或 ; 前换行
不同行为或逻辑的语句集,使用空行隔开,更易阅读。
对于 if...else...、try...catch...finally 等语句,推荐使用在 } 号后添加一个换行 的风格,使代码层次结构更清晰,阅读性更好。
变量和函数使用 Camel命名法。
常量 使用 全部字母大写,单词间下划线分隔的命名方式。
由多个单词组成的缩写词,在命名中,根据当前命名法和出现的位置,所有字母的大小写与首字母的大小写保持一致。
单行注释
必须独占一行。// 后跟一个空格,缩进与下一行被注释说明的代码一致。
多行注释
避免使用 /*...*/ 这样的多行注释。有多行注释内容时,使用多个单行注释。
文档化注释
了便于代码阅读和自文档化,以下内容必须包含以 /**...*/ 形式的块注释中。
细节注释
对于内部实现、不容易理解的逻辑说明、摘要信息等,我们可能需要编写细节注释。细节注释遵循单行注释的格式。说明必须换行时,每行是一个单行注释的起始。
有时我们会使用一些特殊标记进行说明。特殊标记必须使用单行注释的形式。下面列举了一些常用标记:
解释:
TODO: 有功能待实现。此时需要对将要实现的功能进行简单说明。
FIXME: 该处代码运行没问题,但可能由于时间赶或者其他原因,需要修正。此时需要对如何修正进行简单说明。
HACK: 为修正某些问题而写的不太好或者使用了某些诡异手段的代码。此时需要对思路或诡异手段进行描述。
XXX: 该处存在陷阱。此时需要对陷阱进行描述。
变量、函数在使用前必须先定义
在读这本书之前,我对这本书是稍稍有抵触情绪的,我认为这本书无非就是讨论一些枯燥的数学理论知识,读完一章节之后,我发现《数学之美》不单单是将数学,而是涉及到了计算机和人类科技的发展。
第二章讲述了自然语言处理的发展,从语言的规则到统计,从提出机器智能设想的计算机科学之父阿兰·图灵提出的图灵测试至今有六十多年。自然语言处理可以分为两个阶段,早起是科学家走弯路的阶段,科学家们对自然语言处理的认识在人类学习语言的方式上受到了局限,之后才重新认识到了这个问题。从人类在自然语言处理上的发展中,我知道了科学成果都不是一蹴而就的,在一条科学探索的道路上,往往会布满坎坷和荆棘,后人在前人的经验和其他领域的突破中获得契机,在不断的错误和困难中迈向成功。