程序风格和文档

Posted

tags:

篇首语:本文由小常识网(cha138.com)小编为大家整理,主要介绍了程序风格和文档相关的知识,希望对你有一定的参考价值。

适当的注释和注释风格

包含在程序的开头,总结和解释这个程序的作用、程序的关键特点和其他所应用的独特技术。

在一个长程序中,还需要包含一些介绍主要步骤和难以读懂部分的注释。

让注释保持简洁非常重要,这样才不会让程序臃肿或难以读懂。

 

正确的缩进和间距

缩进是用来说明程序的组成部分或语句之间的结构关系。恰当对齐的代码更容易让人阅读和维护。

每个子组成部分或语句要比嵌套它的结构多空两格。

二元操作符的两端都应该增加一个空格。

 

 

以上是关于程序风格和文档的主要内容,如果未能解决你的问题,请参考以下文章

什么是编码风格?为什么要强调编码风格

Doxygen和JavaDoc注释风格(函数头部描述)(没看出有啥区别)

( 转 ) 优秀REST风格 API的设计原则

PEP8特性

php

什么是编码风格?为什么要强调编码风格