在前端开发中，我们经常需要使用打包工具将多个 JavaScript 模块合并为一个文件，以提高网页加载速度。其中，Rollup 是一款流行的打包工具之一，它可以将多个模块打包为一个文件，并且支持生成 ES6 Module、CommonJS、UMD 等多种格式的输出。
在本文中，我们将介绍一个名为 rollup-plugin-hashbang 的插件，该插件可以在 Rollup 打包时自动添加 hashbang 声明到打包后的文件头部，以便于直接执行该文件。下面是详细的使用教程。
安装和配置
首先，我们需要在项目目录下安装 rollup-plugin-hashbang：
--- ------- ---------------------- ----------
然后，在 Rollup 配置文件中引入该插件，并将其作为 Rollup 插件列表的一部分。例如，以下是一个简单的 Rollup 配置文件，其中包含了 rollup-plugin-hashbang 插件：
------ - ------ - ---- -----------------------
------ -------- ---- -------------------------
------ ------- -
------ ---------------
------- -
----- -----------------
------- ------
--
-------- -
---------
-----------
--
--在上面的配置文件中，我们引入了 Rollup 的压缩插件 rollup-plugin-terser，以及 rollup-plugin-hashbang 插件。其中，hashbang() 函数是该插件的初始化函数，它会返回一个 Rollup 插件对象。
基本使用
当我们编译上述的 Rollup 配置文件时，将会生成一个包含 hashbang 声明的 JavaScript 文件。例如，以下是一个简单的 index.js 文件：
-------------- ---- ------------------- ---------
通过 Rollup 打包后，生成的 bundle.js 文件内容如下所示：
-------------- ---- --- ----- - ------- -------- -------------------
在打包后的文件头部，可以看到已经添加了 hashbang 声明 #!/usr/bin/env node，该声明指定了该文件应该由哪个程序来执行（这里指定为 node）。因此，我们可以直接通过命令行来运行该文件：
- ---- -------------- ------ ------
高级选项
除了基本的使用方法外，rollup-plugin-hashbang 还提供了一些高级选项，以便于满足更多的需求。以下是该插件的完整配置选项：
---------- -- -------- --------- --------------- ----- ----- --------------- ------ -- ------ -------- ------ ---- ------ ----- -- -------- -------- --------- ----- ------- ------ --
其中，bang 属性可以指定 hashbang 声明的内容，默认为 #!/usr/bin/env node。force 属性可以控制插件是否强制添加 hashbang 声明，即使该文件没有被当做可执行文件来执行。默认情况下，该属性为 true。ignore 属性可以忽略已经存在 hashbang 声明的文件，不进行重复添加。
示例代码
以下是一个完整的示例代码，包括了 Rollup 配置文件、源代码和打包后的文件：
-- ------------ -------------- ---- ------------------- --------- -- ---------------- ------ - ------ - ---- ----------------------- ------ -------- ---- ------------------------- ------ ------- - ------ --------------- ----------------------------------------------------------- ---------- ---------------------------------------------------------------------------------------