包括文件

有两种方法可以将一个较大的（通常是笨拙的）单个脚本文件拆分为多个文件。

• 脚本包含文件

• 脚本模块

这两个概念相似，然而，如果模块设计为将单个脚本拆分为多个文件的一种方式，则包含文件更多地被设计为在多个脚本之间共享代码。

假设您有一堆您喜欢重复使用的实用函数。您可以将它们复制到每个使用它们的单个脚本中，但这意味着您的脚本文件比它们需要的更大（并且更复杂），并且很难保持它们全部更新。

相反，如果您将实用函数保存在一个包含文件中，则可以将该文件包括到其它脚本中——自动获取其中函数的访问权限，但只需要一份代码副本。

包括文件要求

创建包含文件的最简单方法是使用脚本编辑器。

虽然包含文件就像其它任何文件一样都是脚本文件，但与普通脚本有一些重要的区别：

• 它们的文件名必须以inc_开头（例如 inc_myutils.js）。

• 它们必须与将使用它们的脚本使用相同的语言（例如，您不能从 .vbs 脚本中包括一个 .js 文件）。

• 可以实现OnInitIncludeFile 事件，以向 Opus 提供包含文件的信息，但这并不是必需的。

包含文件可以是私有的或共享的。私有包含文件在捆绑到脚本包中时，只能由该包中的脚本使用。所有已安装的 Opus 脚本均可以使用共享包含文件。要将包含文件标记为共享，必须实现OnInitIncludeFile事件。

使用包含文件

要从另一个脚本使用包含文件，请在脚本文件的顶部使用@include指令，例如，

@include inc_myutils.js

您还可以为包含文件指定最小版本。仅当包含文件通过实现OnInitIncludeFile事件指定了版本时，此方法才有效。

@include inc_myutils.js:1.2

您还可以从脚本编辑器中选择包含文件。