在一个程序中,一个变量只应用于一种用途。就是说,在同一个程序中一个变量不能 身兼几种工作 ②程序的注释 夹在程序中的注释是程序员与日后的程序读者之间通信的重要手段。正确的注释能够帮 助读者理解程序,可为后续阶段进行测试和维护,提供明确的指导。因此,注释决不是可有 可无的,大多数程序设计语言允许使用自然语言来写注释,这就给阅读程序带来很大的方便 一些正规的程序文本中,注释行的数量占到整个源程序的1/3到1/2,甚至更多 序言性注释:通常置于每个程序模块的开头部分,它应当给出程序的整体说明,对 于理解程序本身具有引导作用。有些软件开发部门对序言性注释做了明确而严格的规定,要 求程序编制者逐项列出的有关项目包括:程序标题、有关本模块功能和目的的说明、主要算 法、接口说明、有关数据描述、模块位置、开发简历等。 功能性注释:嵌在源程序体中,用以描述其后的语句或程序段是在做什么工作,不 要解释下面怎么做,因为解释怎么做常常是与程序本身重复的,并且对于阅读者理解程序没 有什么帮助 书写功能性注释,要注意:·用于描述一段程序,而不是每一个语句:·用缩进和空行, 使程序与注释容易区别;·注释要正确 ③视觉组织 利用空格、空行和移行,提高程序的可视化程度。 恰当地利用空格,可以突出运算的优先性,避免发生运算的错误。 自然的程序段之间可用空行隔开 对于选择语句和循环语句,把其中的程序段语句向右做阶梯式移行。这样可使程序的 逻辑结构更加清晰,层次更加分明。 (2)数据说明 在编写程序时,需注意数据说明的风格。为了使程序中数据说明更易于理解和维护, 须注意以下几点。 数据说明的次序应当规范化,使数据属性容易查找。 当多个变量名用一个语句说明时,应当对这些变量按字母的顺序排列 如果设计了一个复杂的数据结构,应当使用注释来说明在程序实现时这个数据结构的 固有特点。 (3)语句结构 在设计阶段确定了软件的逻辑流结构,但构造单个语句则是编码阶段的任务。语句构造 力求简单,直接,不能为了片面追求效率而使语句复杂化 在一行内只写一条语句,并且采取适当的移行格式,使程序的逻辑和功能变得更加明 ■程序编写首先应当考虑清晰性,不要刻意追求技巧性,使程序编写得过于紧凑 程序编写得要简单,写清楚,直截了当地说明程序员的用意。 除非对效率有特殊的要求,程序编写要做到清晰第一,效率第二。不要为了追求效率 而丧失了清晰性。事实上,程序效率的提高主要应通过选择高效的算法来实现 ■首先要保证程序正确,然后才要求提高速度。反过来说,在使程序高速运行时,首先 要保证它是正确的 让编译程序做简单的优化 尽可能使用库函数 避免使用临时变量而使可读性下降。 尽量用公共过程或子程序去代替重复的功能代码段4 ▪ 在一个程序中，一个变量只应用于一种用途。就是说，在同一个程序中一个变量不能 身兼几种工作。 ② 程序的注释 夹在程序中的注释是程序员与日后的程序读者之间通信的重要手段。正确的注释能够帮 助读者理解程序，可为后续阶段进行测试和维护，提供明确的指导。因此，注释决不是可有 可无的，大多数程序设计语言允许使用自然语言来写注释，这就给阅读程序带来很大的方便。 一些正规的程序文本中，注释行的数量占到整个源程序的 1／3 到 1／2，甚至更多。 ▪ 序言性注释 ：通常置于每个程序模块的开头部分，它应当给出程序的整体说明，对 于理解程序本身具有引导作用。有些软件开发部门对序言性注释做了明确而严格的规定，要 求程序编制者逐项列出的有关项目包括：程序标题、有关本模块功能和目的的说明、主要算 法、接口说明、有关数据描述、模块位置、开发简历等。 ▪ 功能性注释 ：嵌在源程序体中，用以描述其后的语句或程序段是在做什么工作，不 要解释下面怎么做，因为解释怎么做常常是与程序本身重复的，并且对于阅读者理解程序没 有什么帮助。 书写功能性注释，要注意：·用于描述一段程序，而不是每一个语句；·用缩进和空行， 使程序与注释容易区别；·注释要正确。 ③ 视觉组织 利用空格、空行和移行，提高程序的可视化程度。 ▪ 恰当地利用空格，可以突出运算的优先性，避免发生运算的错误。 ▪ 自然的程序段之间可用空行隔开； ▪ 对于选择语句和循环语句，把其中的程序段语句向右做阶梯式移行。这样可使程序的 逻辑结构更加清晰，层次更加分明。 (2) 数据说明 在编写程序时，需注意数据说明的风格。为了使程序中数据说明更易于理解和维护，必 须注意以下几点。 ▪ 数据说明的次序应当规范化，使数据属性容易查找。 ▪ 当多个变量名用一个语句说明时，应当对这些变量按字母的顺序排列。 ▪ 如果设计了一个复杂的数据结构，应当使用注释来说明在程序实现时这个数据结构的 固有特点。 (3) 语句结构 在设计阶段确定了软件的逻辑流结构，但构造单个语句则是编码阶段的任务。语句构造 力求简单，直接，不能为了片面追求效率而使语句复杂化。 ▪ 在一行内只写一条语句，并且采取适当的移行格式，使程序的逻辑和功能变得更加明 确。 ▪ 程序编写首先应当考虑清晰性，不要刻意追求技巧性，使程序编写得过于紧凑。 ▪ 程序编写得要简单，写清楚，直截了当地说明程序员的用意。 ▪ 除非对效率有特殊的要求，程序编写要做到清晰第一，效率第二。不要为了追求效率 而丧失了清晰性。事实上，程序效率的提高主要应通过选择高效的算法来实现。 ▪ 首先要保证程序正确，然后才要求提高速度。反过来说，在使程序高速运行时，首先 要保证它是正确的。 ▪ 让编译程序做简单的优化。 ▪ 尽可能使用库函数。 ▪ 避免使用临时变量而使可读性下降。 ▪ 尽量用公共过程或子程序去代替重复的功能代码段