Node.js CLI
2017-08-18 本文已影响81人
喵不留行
man node 命令将列出 Node.js CLI 的有关信息，包括所有允许的 CLI 可选项（options）和 环境变量（Environment Variables）。
NAME
node - Server-side JavaScript runtime
SYNOPSIS
node [options] [v8 options] [script.js | -e "script"] [arguments]
node debug [script.js | -e "script" | <host>:<port>] ...
node [--v8-options]
Execute without arguments to start the REPL.
DESCRIPTION
Node.js is a set of libraries for JavaScript which allows it to be used outside of the
browser. It is primarily focused on creating simple, easy to build network clients and
servers.
OPTIONS
-v, --version
Print node's version.
-h, --help
Print node command line options. The output of this option is less detailed than
this document.
-e, --eval "script"
Evaluate the following argument as JavaScript.
-p, --print "script"
Identical to -e but prints the result.
-c, --check
......
常用的 Node.js CLI 可选项
- -v 或 --version：查看当前使用的 node 版本
$ node -v
v6.11.2
- -h 或 --help：查看帮助，快捷查看部分支持的可选项和环境变量
$ node -h
Usage: node [options] [ -e script | script.js ] [arguments]
node debug script.js [arguments]
Options:
-v, --version print Node.js version
-e, --eval script evaluate script
-p, --print evaluate script and print result
-c, --check syntax check script without executing
-i, --interactive always enter the REPL even if stdin
does not appear to be a terminal
......
- -e 或 --eval '代码'（>=v0.5.2）：命令行执行代码。
$ node -e 'console.log("-e test")'
-e test
- -p 或 --print '代码'（>=v0.6.4）：输出结果的带命令行执行代码
$ node -p 'console.log("-p test")'
-p test
undefinded
$ node -p '2+3'
5
- -c 或 --check（>=v5.0.0）：检查指定脚本（文件）的语法，不实际执行。
$ node -c 'index.js'
/Users/cxswow/Documents/work/tmp/test/index.js:3
console.log('a'
^^^
SyntaxError: missing ) after argument list
at startup (bootstrap_node.js:134:11)
at bootstrap_node.js:535:3
- --inspect[=host:port] (>=v6.3.0)：对指定地址和端口激活
inspector（实时调试观察） ，默认地址端口：127.0.0.1:9229。调试工具与 Node.js 实例通过一个使用 Chrome Debugging Protocol 的 tcp 端口进行通信。
$ node --inspect
Debugger listening on port 9229.
Warning: This is an experimental feature and could change at any time.
To start debugging, open the following URL in Chrome:
chrome-devtools://devtools/bundled/inspector.html?experiments=true&v8only=true&ws=127.0.0.1:9229/******
>
在浏览器里打开那个链接将看到和在谷歌浏览器里打开检查以后类似的调试器。
- --inspect-brk[=host:port]（>=v7.6.0）：与 --inspect 类似，不同的是会在用户代码的第一行暂停。
$ node --inspect-brk
Debugger listening on ws://127.0.0.1:9229/*********
For help see https://nodejs.org/en/docs/inspector
-
--zero-fill-buffers（>=v6.0.0）：在新建的 Buffer 实例时全都用 0 填充，因为新建的 Buffer 实例里可能包含敏感数据。
-
--prof-process（>=v6.0.0）：输出 V8 profiler 的输出。
node --prof-process index.js命令正常运行index.js然后生成一个 isolate- 开头的 log 文件，然后就可以运行node --prof-process isolate-0x103000000-v8.log(刚生成的文件名) > output.txt来生成 output.txt 文件，文件里包含 V8 profiler 的各种信息，如 JavaScript 耗时、C++ 层耗时等。
Statistical profiling result from isolate-0x103000000-v8.log, (312 ticks, 14 unaccounted, 0 excluded).
[Shared libraries]:
ticks total nonlib name
43 13.8% /usr/lib/system/libsystem_malloc.dylib
5 1.6% /usr/lib/system/libsystem_kernel.dylib
3 1.0% /usr/lib/system/libsystem_c.dylib
2 0.6% /usr/lib/system/libsystem_platform.dylib
1 0.3% /usr/lib/system/libsystem_pthread.dylib
1 0.3% /usr/lib/libc++abi.dylib
1 0.3% /usr/lib/libc++.1.dylib
[JavaScript]:
ticks total nonlib name
1 0.3% 0.4% Builtin: StoreICStrict_Uninitialized
[C++]:
ticks total nonlib name
21 6.7% 8.2% t node::(anonymous namespace)::ContextifyScript::New(v8::FunctionCallbackInfo<v8::Value> const&)
......
V8 可选项
node --v8-options 命令将输出所有可用的 V8 可选项（超级多！！）。
SSE3=1 SSSE3=1 SSE4_1=1 SAHF=1 AVX=0 FMA3=0 BMI1=0 BMI2=0 LZCNT=0 POPCNT=1 ATOM=0
Usage:
shell [options] -e string
execute string in V8
shell [options] file1 file2 ... filek
run JavaScript scripts in file1, file2, ..., filek
shell [options]
shell [options] --shell [file1 file2 ... filek]
run an interactive JavaScript shell
d8 [options] file1 file2 ... filek
d8 [options]
d8 [options] --shell [file1 file2 ... filek]
run the new debugging shell
Options:
--experimental_extras (enable code compiled in via v8_experimental_extra_library_files)
type: bool default: false
--use_strict (enforce strict mode)
type: bool default: false
--es_staging (enable test-worthy harmony features (for internal use only))
type: bool default: false
--harmony (enable all completed harmony features)
type: bool default: false
--harmony_shipping (enable all shipped harmony features)
type: bool default: true
--harmony_array_prototype_values (enable "harmony Array.prototype.values" (in progress))
type: bool default: false
--harmony_function_sent (enable "harmony function.sent" (in progress))
type: bool default: false
--harmony_tailcalls (enable "harmony tail calls" (in progress))
type: bool default: false
--harmony_sharedarraybuffer (enable "harmony sharedarraybuffer" (in progress))
type: bool default: false
--harmony_do_expressions (enable "harmony do-expressions" (in progress))
type: bool default: false
--harmony_class_fields (enable "harmony public fields in class literals" (in progress))
type: bool default: false
--harmony_async_iteration (enable "harmony async iteration" (in progress))
type: bool default: false
--harmony_dynamic_import (enable "harmony dynamic import" (in progress))
type: bool default: false
--harmony_promise_finally (enable "harmony Promise.prototype.finally" (in progress))
type: bool default: false
......
常用 V8 可选项
- --harmony：JavaScript 下一个版本是 Harmony，这个可选项让我们可以使用下一个版本已经实现的功能，像是 Async 之类的。
- --max_old_space_size：可以设置旧空间堆最大的大小，直接影响进程可以分配的内存。在低内存环境下很有用的一个选项。
- --optimize_for_size：和之前一个可选项使用情景类似，这个选项可以指示 V8 牺牲一些性能来优化内存空间大小。
常用的 Node.js CLI 环境变量
- NODE_DEBUG=module[,…]：列出的模块将输出 debug 信息，模块名字之间用逗号分隔。
$ NODE_DEBUG=module,fs,http,timers node index.js
不是所有的原生模块都支持 debug 输出，目前支持的模块有：
cluster, net, http, fs, tls, module, timers。
- NODE_PATH=path[:...]：添加额外的 Node.js 寻找模块的地址，不同地址之间用冒号分隔（ windows 上面用分号分隔）。
参考：
Node.js v6.11.2 Documentation
Mastering the Node.js CLI & Command Line Options
