五分钟了解 node.js shebang-金马国际

本文最初发布于 medium 网站，经原作者授权由 infoq 中文站翻译并分享。

是一种解释性语言，需要将其源代码提供给某些解释器才能运行。如果要使用运行 javascript 文件，通常会运行以下命令：

$ node yourfile.js

输入解释器（node）的名称后，你就明确告诉了外壳如何运行脚本。

但是这些知识可以放在脚本本身中，这样就可以像运行二进制文件一样直接运行它：

$ ./yourfile.js

仅当你对该文件有执行权限（例如，可以使用 chmod u x yourfile.js 设置）并设置了正确的“shebang”时，此方法才有效。

shebang

shebang 或 hashbang（#!代码的英文发音）是文件的第一行，它告诉 os 使用哪个解释器。它通常看起来像这样：

#!/absolute/path/to/the/interpreter [optional params]

shebang 是一项操作系统特性，可用于运行任何解释语言：python、perl 等。对于 node.js，它可以（但通常不会）看起来像这样：

#!/usr/bin/node

只有 shebang 在文件的第一行时，node.js 才会高兴地将其忽略为注释（即使它前面有空行或//comment 行也不会起作用）。浏览器也会将其忽略（chrome74 ，ff67 ）。

多数人在/usr/bin/node 上都有一个 node.js 二进制文件或符号链接。如果 node.js 不在/usr/bin/node 上，操作系统就会抱怨了。例如 bash 会说 bad interpreter: no such file or directory script won’t execute。但有没有办法告诉操作系统使用 node.js 运行脚本，而不用在乎它安装在哪里呢？

#!node是没用的，因为 shebang 需要绝对路径。

认识一下 env 吧

env 主要用于在修改后的环境中运行命令。这里的重点是“命令”，因为 env 几乎总是位于/usr/bin/env，而“命令”可以是 path 上的任何内容。

如果我们不是写/usr/bin/node 而是写/usr/bin/env node，我们就会告诉 os 运行 env，而 env 将运行 node，最后 node 将依次执行脚本。

简单来说

这是 node 脚本最常见的 shebang：

#!/usr/bin/env node

但是，env 还可以使用其他一些技巧。

将参数传递给 node.js

将-s 选项传递给 env 会使它解析之后发生的一切，从而打开一扇新的大门：将参数传递给命令。

例如，假设我们要运行带有特殊标志的 node，以在运行当前文件时启用 esm 模块。我们可以使用这个 shebang：

#!/usr/bin/env -s node --experimental-module

再举一个例子：如果我们想在运行当前脚本之前运行另一个脚本，可以使用 node 的-r 选项：

#!/usr/bin/env -s node -r ./my/other/file.js

或打开检查口：

#!/usr/bin/env -s node --inspect

请注意，如果你运行诸如 nodeyourfile.js 之类的脚本，node.js 将不会尝试解析 shebang 中的参数，而只会忽略它。内核在运行文件之前使用 shebang 来确定如何运行它。

设置环境变量

还记得我们说过 env 可以在修改后的环境中运行命令吗？实际上这就是它名称的来源，而且它的功能非常强大。假设我们希望脚本以生产模式运行，我们可以设置 node_env 环境变量：

#!/usr/bin/env -s node_env=production node

否则，运行脚本时 node_env 将为 undefined 或使用用户终端的设置。

node.js许多环境变量。例如，我们可以使用 node_options 传递下列 cli 标志：

#!/usr/bin/env -s node_options=--experimental-modules node

从一个空环境开始

如果我们希望脚本在运行时不访问用户终端上的任何环境变量，则可以使用-i 标志来运行它，该标志代表“忽略环境”：

#!/usr/bin/env -s -i node

符号-相当于-i，所以我们也可以这样写：

#!/usr/bin/env -s - node

强制禁用 debug

也许我们不想清除所有环境变量，但要屏蔽其中一些。例如 debug（如果你使用的是流行的 debug 包）。也许我们不希望脚本用户将 debug 作为脚本运行时设置标志。那么我们使用-u 标志代表未设置的环境变量。

#!/usr/bin/env -s -u=debug - node

如果用户以debug=* ./yourfile.js运行脚本，他们将看不到任何调试信息，但你还是可以用debug=* node ./yourfile.js运行脚本，从而看到 debug 输出。

锁定 node.js 运行时版本

有时你想锁定用于运行脚本的 node 版本。在 npm@3 之前，我们可以使用 enginestrict，但是该功能已移除，现在我们只能，它可能位于脚本旁边也可能不在，取决于 engine-strictconfig 配置标志的设置。

但是有一种更简单的方法。由于 node 也是 npm 包，并且 npx 允许运行任何 npm 包，因此你可以编写：

#!/usr/bin/env -s npx node@6

这可能会在运行脚本后尝试下载请求的 node 版本（因此，如果 npx 缓存中不存在所请求版本的 node，则无法在没有互联网连接的情况下运行）。

提示：你可以使用 process.version 检查节点版本

使用 typescript 运行它

没有规则说我们必须运行 node。假设和 ts node 全局可用（npm -i g typescript ts-node），我们可以指定 ts-node 作为解释器：

#!/usr/bin/env ts-node

并让它作为 typescript 程序运行文件。

在这些示例中，文件都可以使用.js 扩展名或你喜欢的其他任何文件类型，甚至可以没有扩展！

原文链接：