翻译：Scripting Style Guide

XTalk, Lingo, 以及其他一些第四代语言的技巧 sflj www.it55.com kg^&fgd

Richard Gaskin
Fourth World Media Corporation
http://www.fourthworld.com/casestudies/index.html sflj www.it55.com kg^&fgd

Adapted from The Michael and Richard Style Guide,
presented at the SuperCard Developer Conference in San Francisco, California, January 1996.
With six revisions since then, it was last revised 18 September, 2001.

Copyright © 1994-2001 Fourth World
Portions Copyright © 1994-1996 Michael Silver and Barnacle Software

vd;k;l www.it55.com rdfg

This document may be distributed freely only in its complete, unmodified form, including this header and copyright information.

免费资源www.it55.com

介绍

在我们编程生涯的某个时刻，我们都会写出一些蹩脚的程序（除了我的朋友Mark Lucas，他是自成一格），你知道这个情形：六个月后你想在你的程序中加入一些新的功能或者更好的检查错误， 但是你却不知道给从何下手了，我们称呼这种程序为“spaghetti code”, 它可以让你在查询中消耗大量的时间，这也是本文的由来。 IT资讯之家 www.it55.com

几个好习惯就可以让你的程序更加可靠，并缩短你的工作时间，当然最开始还是需要你一点点自律，而你一旦习惯了，并应用于你的每天的工作，它就会成为你的本能和下意识，而不再需要你花功夫提醒自己了。 免费资源www.it55.com

有很多原因你应该在写程序的时候保持良好的习惯，例如： IT资讯之家 www.it55.com

• 易读易懂
• 在团队中保持一致性 
• 更容易在未来修改增强
• 让你的程序可以骄傲的与人共享
• 给女孩子留下一个好印象（或者是男孩子）

这里的提示都反映了一些世界级的脚本编程员的实践经验，我们应该先对他们致敬:Michael Silver, Ken Ray, Mark Lucas, 还有 Mark Hanrek 都是我所知道的最好的SuperCard程序员，有一次我们交流各自的代吗，发现我们不约而同的使用了类似的代码风格，本文的初稿就反映了在SuperCard上我们共同的兴趣，而且也局限在这个范围，1996年的SuperCard的开发者的大会上本文的初稿是脚本编程技术小组讨论的一部分，那一年 SuperCard 2.5赢得了当年的最佳多媒体开发工具的Mac Eddy奖。 

www.it55.com在线教程

从那时开始，本文就几易其稿，扩展到包括其他一些类似的脚本语言的技巧，同时我也收集了大量的程序员的经验和技巧，包括 Scott Raney, Kevin Miller, Steven McConnell, Jad Santos, 还有 Alex Bronstein. 从他们教会我的内容，本文可以说对那些喜欢HyperTalke类型语言，包括其他一些语言的编程员来说，应该是很有帮助。 www.it55.com

当你阅读这些提示的时候，你也许感到这些代码风格不是你喜欢的那种，如果你觉得你的风格适合你，你不必改变。

免费资源www.it55.com

这些只不过是一个指南，人们越多的使用这些方法，就越容易交换代码，解决问题就越快捷，就可以花更多的时间和家人在一起，并且让这个世界更好。 www.it55.com在线教程

说了这么多，还是要你书写或者重写你的代码时遵照这些建议，在容易维护的代码和有效的代码之间有一个细微的界限，你自己来确定怎样取舍。

本文仍在改进中，我们用它来教授合作对象并且与他们合作，所以时间允许的情况下它是随着经验在不断的修改中，如果你有好的建议和提示，请你email我们scriptstyle@fourthworld.com.

it55.com

好，言归正传。 45398 www.it55.com it55学习IT知识，享受IT生活 4dfkjn

常用的技巧

几个防止spaghetti code的建议

vd;k;l www.it55.com rdfg

澄清程序的流程

一种避免 spaghetti code的方法就是让你的代码的逻辑显而易见。例如，你需要一个句柄来完成好多个不同的启动过程，你最好把它拆分成多个句柄，并且每个句柄只负责 一个特定的工作，如果你能使用描述性的名字，你就可以很容易的掌握这个句柄是做什么用的：

on startup InitMenus InitWindows InitPrefsend startup 
vd;k;l www.it55.com rdfg
 

解释这些拆分的程序调用所需的额外时间试可以忽略不计的，而且分离这些程序可以使你在跟踪代码的漏洞的时候更方便。 IT资讯之家 www.it55.com

为了让你的代码流程更清晰，你可以先写注释，把你的代码所要完成的工作写成注释，然后再在其中填写要执行的代码，这个技巧对于早期处理复杂的程序单元也非常有用，它可以让你按照步骤的思考来解决问题。

很多词在脚本语言里有缩写的形式，请使用它们，它们节省空间并且从视觉上来说让你的变量名和句柄名更突出，你还可以少打几个字符。 45398 www.it55.com it55学习IT知识，享受IT生活 4dfkjn

你可以用括号来把逻辑和算法表达式集合在一起，让代码简洁:

www.it55.com

if (the vis of wd "myWindow") then

而不是:

www.it55.com在线教程

if the vis of wd "myWindow" = true

请记住，用 "=" 而不是 "is"来表达比较，这可以让你的比较式看起来更显眼。

45398 www.it55.com it55学习IT知识，享受IT生活 4dfkjn

有效的注释

作为一般的原则，每一段代码如果其功能不是显而易见的话，都有必要加上注释。例如：

这个就不必要: 45398 www.it55.com it55学习IT知识，享受IT生活 4dfkjn

-- Set the cursor to watch:set the cursor to watch 
45398 www.it55.com it55学习IT知识，享受IT生活 4dfkjn
 

但是这个代码段就有必要写一个简短的说明: www.it55.com

-- Update each card with the current date:set the cursor to watchput the short date into tDaterepeat with i = 1 to the number of cds put tDate into fld "Date" of cd iend repeat 
it55.com
 

注释也可以用来作为视觉的引导，来分别不同的代码段落，这里就是一个用注释来视觉分辨相关句柄的例子: 免费资源www.it55.com

--=============================================---- WINDOW ROUTINES ---- DocWindowRect()-- -- Returns the default size for new document windows--function DocWindowRect put the screenrect into r add 4 to item 1 of r add 4 to item 2 of r subtract 4 from item 3 of r subtract 4 from item 4 of r return rend DocWindowRect-- UpdateAllWindows---- Allows each open window to refresh itself--on UpdateAllWindows

（阅读次数：）