32、编程中的风格、测试与文档

编程中的风格、测试与文档

1. 编程风格与文档

编程风格对于程序的调试和维护至关重要。良好的编程风格包括使用有意义的名称、正确的缩进、适当的空行和注释。例如，在VB中，有一个很有用的功能是将合适的数据项设为常量。同时，类应该有明确的内聚目的，嵌套的 If 语句、循环和复杂条件应谨慎使用。

以下是一段搜索程序的代码示例：

wanted = CInt(InputTextBox.Text)
index = 0
state = stillSearching
While state = stillSearching
    If wanted = table (index) Then
        state = found
    ElseIf index = maxIndex Then
        state = notFound
    End If
    index = index + 1
End While
If state = found Then
    ResultTextBox.Text = “found”
Else
    ResultTextBox.Text = “not found”
End If

这段代码将各种测试分离， While 循环中的条件清晰简单，其他测试也分开且简单，整体程序可能更简单。这说明一个程序往往可以用不同的方式编写，有些解决方案比其他的更简单、更清晰。有时候，通过使用标志重写程序片段，可以避免条件的复杂性。

文档是程序员的一大难题，但当你需要接手别人的程序时，就会意识到它的重要性。商业组织通常鼓励