不得不看的LabVIEW新手5大错误

　　图 5. LabVIEW 2012中的模板和项目范例使得理解软件架构变得非常轻松。

　　关于LabVIEW架构的更多信息，请访问在线自学培训（ni.com/self-paced-training） for LabVIEW核心课程2的“设计模式”。

　　不重视文档记录

　　优秀的代码文档可以有效地帮助他人理解自己写的程序。遗憾的是，许多程序员通常在开发周期末期功能开发结束之后才开始进行文档撰写。这使得用于对代码进行文档记录的时间变得非常少。正确的做法应该是在开发过程中就需抽出时间来开始进行文档记录。文档对于编程人员自身也非常有用，尤其是当他们过段时间回来看代码却不记得当初他们为什么选择某些代码时。程序员经常会一边喝着咖啡，一边熬夜编程，这往往会出现“短暂失忆”。而文档则可以帮助程序员进行回忆。

　　一般情况下，相对于基于文本的程序，LabVIEW的图形化特性使得程序阅读更为容易，但是有效的文档记录可以减少“解码”程序所需的时间。添加文档注释到程序框图的最简单方式是使用自由标签。您可以在框图的空白位置双击左键，并输入文字，添加注释。然后，使用箭头标记来指向自由标签引用的特定代码。如果需要添加图片，则可将它们复制到剪贴板，然后粘贴到程序框图中。物理系统图片和数学公式均有助于清晰说明程序框图内的代码上下文。

　　图 6.架构正确且文档记录充分的代码不仅可帮助其他人理解您的代码，也可帮助您更好地理解自己的代码。

　　对代码进行文档记录不仅只是针对复用程序库，而应该是针对每一个程序。当一个人需要为其他人讲解时，他对该主题将会有更深刻的理解。文档记录从本质上看就是在迫使程序员进行讲解，以帮助他们更好地了解自己的代码。

　　关于文档记述的更多信息，请访问在线自学培训LabVIEW核心课程1的“对代码进行文档记录”。

　　LabVIEW旨在帮助工程师和科学家更成功地应对全球最严峻的挑战。LabVIEW社区拥有庞大的工程师和科学家会员，为其提供了一个有效的平台来与他人分享知识。如果您愿意分享自己所犯过的新手错误，请发布到bit.ly/lvrookiemistakes。