20190919-5 代码规范,结对要求

此作业要求参见:https://edu.cnblogs.com/campus/nenu/2019fall/homework/7630

结对伙伴:王志文

要求1 《代码规范》包括10项条款。制定条款的目的是在程序设计的过程中(触犯和)约束代码风格,希望切实可行,容易观察和客观检验。

根据本次结对编程所的经验以及我们所犯的错误,我与贺敬文同学总结定义了以下代码规范:

1、格式:

1). 每个函数的行数不能大于60行。

2). 操作符左右各加一个空格,不要为了对齐增加空格。

3). 函数定义之间空两行,函数内逻辑无关段落之间空一行,其他地方尽量不要再空行。

4). if/for/while语句中,即使执行语句只有一句,也必须另起一行。 

5). 单行代码很长,不能一次性映入眼帘,则另起一行,规范排版。

6). 缩进:4个空格的缩进(编辑器都可以完成此功能,默认为pycharm的自动缩进),不要使用Tap,更不能混合使用Tap和空格。

7). 变量的声明尽量集中在一起。与功能语句用空行分开。

2、命名:

8). 变量和函数的命名使用具有其功能含义的英文单词或词组简写。

9). 函数命名使用全部小写的方式,可以使用下划线。。

10).定义的变量名不宜过长,适当缩写,但可以被识别出原单词含义。

3、注释:

11).行注释:在一句代码后加注释。“#”号后空一格,段落间用空行分开。尽量避免无意义的注释。

要求2 记录完成本周作业过程中,《代码风格规范》执行情况。包括记录每一条规则的违反和纠正、次数,规范中某项条款的增强、消弱、或废除。

 

条款违反和纠正情况条款变动情况
1违反1次,转换逆波兰表达式函数代码过长减弱规则,由60行变为70行
2违反17次,已纠正规则有效,无更改
3函数逻辑不清,多次忘记空行弱化规则,变量定义和功能实现空一行
4无违反规则有效,无更改
5无违反规则有效,无更改
6由于Python中if 和else 的语句缩进要自行控制。共违反20次,互相提醒都已纠正。规则有效,无更改
7违反5次,3次变量名忘记集中定义,2次忘记使用空行隔开规则有效,无更改
8违反9次,3个函数,6个变量名用的拼音规则有效,无更改
9无违反规则有效,无更改
10规则无效
11违反2次,#后忘记空格规则有效,无更改

转载于:https://www.cnblogs.com/hejw031/p/11579498.html

评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值