Node.js v12.16.2 的命令行选项（Command Line Options）允许用户定制运行时环境的行为

Bol5261

已于 2025-04-03 17:29:02 修改

阅读量1.7k

点赞数

分类专栏： NodeJs(Google V8 JavaScript) Javascript(Promise/asyncAwait) Npm(Node Package Manager) 文章标签： java

于 2020-04-16 19:44:45 首次发布

本文链接：https://blog.csdn.net/blog_programb/article/details/105545464

版权

本文详细介绍了Node.js的各种命令行选项，包括用于内置调试、脚本执行、运行时配置等的功能。涵盖了从V8选项到环境变量的全面指南，帮助开发者充分利用Node.js的强大功能。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

Node.js v12.16.2 的命令行选项及其作用

Node.js 提供了一系列的命令行选项（Command Line Options），用于自定义其运行时行为。这些选项可以用来调整 TLS 配置、加载额外的模块以及设置调试功能等。

设置默认最小 TLS 版本

通过 --tls-min-v1.3 选项，可以将默认的最低 TLS 协议版本设置为 TLSv1.3。这有助于提高安全性，因为较新的协议通常具有更强的安全特性。需要注意的是，在某些旧环境中可能不支持 TLSv1.3，因此可以根据需求选择是否启用此选项。

如果需要兼容更广泛的客户端，则可以选择保留默认值 TLSv1.2 或更低版本作为最小支持标准。对于大多数现代应用程序而言，强制使用更高版本的加密协议是一个良好的实践。

自定义启动参数

除了上述提到的关于安全性的控制外，还有许多其他的 flag 可以影响程序执行过程中的各个方面：

--inspect: 启用远程调试模式，允许开发者连接浏览器或其他工具来查看代码状态并进行断点操作。
**--require module_name (or -r)`: 在脚本之前先引入指定名称的扩展包或初始化逻辑；这对于框架集成特别有用。
--trace-warnings: 当遇到潜在问题警告时打印堆栈跟踪信息，便于定位错误源头。

以上只是部分可用的功能列表，并不代表全部可能性——具体完整的文档应该查阅官方手册获得最新最全的信息。

node --help

上面这条指令能够展示当前安装好的节点解释器所支持的所有开关描述。

以下是几个实用的例子演示如何运用这些 flags 来改变常规流程:

假设我们有一个简单的 HTTP server 文件叫做 app.js :

const http = require('http');

http.createServer((req,res)=>{
   
    res.writeHead(200,{
   "Content-Type":"text/plain"});
    res.end("Hello World!");
}).listen(8080);
console.log(`Server running at http://localhost:8080`);

如果我们想在这个基础上开启 inspector 功能的话就可以这样做:

node --inspect ./app.js

此时会看到类似下面这样的提示消息:

Debugger listening on ws://127.0.0.1:9229/...
For help see https://nodejs.org/en/docs/inspector
Server running at http://localhost:8080/

然后就能借助 Chrome DevTools 进入交互式的界面监控整个进程啦！

另外再举个例子说一下怎么预加载外部依赖项吧。假如我们的项目需要用到 dotenv 库读取 .env 中存储的秘密变量，那么可以在调用 main script 前加上如下片段实现自动注入环境配置的目的:

node -r dotenv/config index.js

这样一来就无需手动编写繁琐的 setup steps ，从而简化了日常维护工作量。

注意事项

尽管可以通过 CLI 参数灵活调节很多方面的事情，但在生产环境下还是应当谨慎对待每一次改动以免引发不可预见的风险。务必测试清楚每种场景下的表现后再推广至正式线上服务之中去。

Node.js v12.16.2 的命令行选项（Command Line Options）允许用户定制运行时环境的行为。其中一项重要的选项是--tls-min-v1.3。这个选项设置tls.DEFAULT_MIN_VERSION默认为TLSv1.2，这是从Node.js 12.x版本开始的标准。然而，这个选项的存在是为了向后兼容旧版的Node.js，允许用户强制使用更安全的TLS版本1.3，即使在那些不自动升级到最新标准的环境中。

具体来说，如果你想要在启动Node.js时指定这个选项，你可以这样操作：

node --tls-min-v1.3 your_script.js

这会确保你的脚本在连接到支持TLS 1.3的服务器时能获得最佳安全性。

Node.js 提供了一些命令行选项来控制其运行行为。以下是一些常用选项：

–harmony: 这个选项允许你在 Node.js 中使用 ECMAScript Harmony 特性，这是早期版本的 ES6 规范。node --harmony filename.js
–inspect: 启动 Node.js 以进行远程调试，通过浏览器或其他工具连接到运行中的实例。node --inspect filename.js
–max-old-space-size: 设置最大堆内存大小，避免因内存溢出而终止程序。node --max-old-space-size=4096 filename.js
–require: 指定要加载的模块名，用于动态加载额外的模块。node --require mymodule.js filename.js
–eval: 直接在命令行中评估给定的 JavaScript 表达式。node --eval "console.log('Hello from eval!')"
–v8-options: 设置 V8 引擎的配置参数，如垃圾回收策略。node --v8-options="--expose_gc" filename.js

请注意，不是所有选项都适用于所有版本的 Node.js，具体可查阅官方文档或使用 node --help 获取更多信息。

在Node.js中，如果你想要查看由Commander.js创建的应用程序的所有可选命令行参数，你可以按照以下步骤操作：

首先，确保已经安装了commander.js。如果还没有安装，可以在项目目录下运行npm install commander来添加依赖。
安装完成后，在你的主应用文件（通常是一个.js文件）中，导入并使用Commander模块来定义和解析命令行选项。例如，这可能包括标志(flags)和参数(arguments):

const program = require('commander');

program
  .option('-f, --file <path>', '指定文件路径')
  .option('--verbose', '开启详细模式')
  .parse(process.argv);

使用parse方法解析传入的命令行参数。这会触发Commander解析器的行为，它会显示帮助信息，其中包含了所有定义的选项及其描述。当你在终端中运行你的脚本但未提供任何参数时，会自动显示这个帮助信息：

node your-app.js --help

这样，你就能看到所有可用的命令行选项以及它们的用途。

Commander.js允许你自定义帮助文档以清晰地展示命令及其选项。以下是基础用法中定义命令和选项时如何设置帮助信息:

定义命令：

program
  .command('your-command')
  .description('描述你的命令')
  .action(() => {
     
    console.log(`正在执行 "${
       program.name}" 命令`);
  });

在这里，.description() 方法用于提供命令的简短描述。

定义选项：
```
program
  .option('-o, --option-name <value>', '描述选项的作用和默认值');
```
.option() 接受两个参数：标志（ -o 或 --option-name）和描述。你可以指定可选的默认值。
显示帮助文档：
```
program.help();
```
调用 program.help() 显示命令行帮助，包含所有已定义的命令和选项。
定制帮助标题和版本信息：
```
program.version('v1.0.0')
  .usage('[options] command [arguments]');
```
.version() 设置程序的版本，.usage()