process 进程对象:环境变量、工作目录与退出

读取运行配置、确定文件路径的起点,并正确设置脚本退出结果。

🎯 引言

学完这篇文章,你能读取运行配置、确定文件路径的起点,并正确设置脚本退出结果。


🧱 process:读取和控制本次 Node.js 运行的全局对象

process 是 Node.js 自动提供的一个全局对象。你的代码通过它读取本次运行的启动参数、环境配置和工作目录,也可以设置程序结束时的成功或失败结果。 它不是一个函数,不需要自己创建,也不需要安装或导入就能使用。

例如,你写了一个文件处理脚本,需要知道“这次要处理哪个文件”“从哪个目录查找文件”“处理失败后怎样告诉终端”。这些信息和操作就由 process 提供:

你要做的事使用的成员取得的信息或产生的作用
取得启动时传入的文件名等参数process.argv返回启动参数数组
读取运行环境提供的配置process.env取得环境变量,例如服务端口
确认相对文件路径从哪里开始查找process.cwd()返回当前工作目录
让调用脚本的工具知道任务失败process.exitCode设置程序结束时返回的退出码

这里的“本次运行”是什么意思?main.mjs 是保存在磁盘上的代码文件;执行一次 node main.mjs,操作系统就启动一个运行它的 Node.js 进程。代码中的 process 对应这个进程,而不是磁盘上的文件。

同一个 Node.js 进程加载的多个模块,使用的是同一个 process;在两个终端分别启动脚本,则是两次独立运行,各有自己的 process。因此,它提供的是当前这次运行的信息,不是电脑上所有程序的信息。

命令行参数已在程序运行方式中演示。下面分别练习环境配置、工作目录和退出结果,每组示例替换保存为 process-demo.mjs;除加载 .env 时使用专门命令外,均用 node process-demo.mjs 运行。


⚙️ env:读取环境配置

环境变量是启动环境提供给程序的配置值,适合保存不同运行环境下的端口等配置。先在同目录创建 .env:

.env
PORT=3000

用 process.env.PORT 读取端口配置:

process-demo.mjs
console.log(process.env.PORT)

执行 node --env-file=.env process-demo.mjs,输出 3000。这里的值是字符串,不是数字;--env-file 是 Node.js 24.19.0 的内置文件加载选项,不需要安装包。

如果不加载文件,且系统也没有提供 PORT,结果是 undefined。.env 放在目录里不会自动生效;系统已有同名环境变量时通常优先使用系统值。

配置需要转换并验证

读取成功不代表输入合法。将脚本替换为:

process-demo.mjs
const port = Number(process.env.PORT ?? '3000')
const valid = Number.isInteger(port) && port >= 1 && port <= 65535
console.log(valid ? port : '端口配置不正确')

文件为 PORT=3000 时输出数字 3000,改为 PORT=abc 时输出 端口配置不正确。检查范围在这里选择 1 到 65535,表示使用一个明确的服务端口。

不要输出整个 process.env,其中可能包含凭证;包含敏感内容的 .env 也不应提交到公开仓库。


📍 cwd:取得执行命令时所在的目录

process.cwd() 返回当前工作目录。下面没有切换程序内部的工作目录,因此你在哪个目录执行启动命令,它就返回哪个目录。

把下面的代码保存为 /work/demo/process-demo.mjs:

process-demo.mjs
console.log(process.cwd())

同一个文件,分别从两个位置启动:

在 /work 目录启动

cd /work
node demo/process-demo.mjs

输出 /work。虽然脚本放在 demo 里,但执行命令时终端位于 /work,工作目录就是 /work。

在 /work/demo 目录启动

cd /work/demo
node process-demo.mjs

输出 /work/demo。这次终端已经进入脚本所在目录,所以工作目录也是 /work/demo。

终端执行命令时的位置启动命令process.cwd() 的返回值
/worknode demo/process-demo.mjs/work
/work/demonode process-demo.mjs/work/demo

/work/demo 是示例路径,练习时替换成你自己的目录。脚本始终是同一个文件,改变的是启动命令所在的目录。

这会影响文件操作:如果脚本读取 ./config.json,第一种启动方式会查找 /work/config.json,第二种会查找 /work/demo/config.json。要读取始终放在脚本旁边的配置,应使用前面 path 篇介绍的模块位置定位方式。


🚪 exitCode:检查失败时,阻止后续命令继续执行

process.exitCode 用来告诉启动这个脚本的终端或工具:任务成功了,还是失败了。 例如启动服务之前先检查端口配置,配置不合法就应该停止,不能继续启动。

console.error 只把错误文字显示给人看;终端不会根据文字判断任务成败。它读取的是程序结束时的退出码:0 表示成功,非零表示失败。脚本正常结束且没有设置失败退出码时,通常返回 0。

在检测到失败的分支设置 exitCode

沿用前面的 .env,新建 check-port.mjs:

check-port.mjs
const port = Number(process.env.PORT)
const valid = Number.isInteger(port) && port >= 1 && port <= 65535

if (!valid) {
    console.error('端口配置不正确,请检查 PORT')
    process.exitCode = 1
} else {
    console.log('端口检查通过')
}

配置不合法时,错误文字说明原因,exitCode = 1 把失败状态交给调用者。成功分支不设置失败码,脚本正常结束时返回 0。

让终端根据检查结果决定是否继续

在 macOS/Linux 终端或 PowerShell 7 中运行:

node --env-file=.env check-port.mjs && echo "允许执行下一步"

这里 && 后的命令只在前一个命令成功时执行。echo 用于观察后续步骤有没有被执行;实际项目可以把它换成启动服务或构建项目的命令。

.env 内容检查脚本的退出码终端结果
PORT=30000输出“端口检查通过”,然后输出“允许执行下一步”
PORT=abc1输出端口错误,不执行后面的 echo

如果删掉失败分支中的 process.exitCode = 1,即使打印了错误,脚本也会正常结束,后面的命令仍会执行。退出码的用途就在这里:让其他工具能够判断失败,而不只是让人看到报错。

单独查看脚本返回的退出码

macOS/Linux 终端可以连续执行:

node --env-file=.env check-port.mjs
echo $?

PowerShell(包括不支持 && 的 Windows PowerShell 5.1)可以连续执行:

node --env-file=.env check-port.mjs
$LASTEXITCODE

配置为 PORT=abc 时,退出码输出 1;改回 PORT=3000 后输出 0。查询前不要插入其他命令,否则读到的可能已不是这个脚本的结果。

exitCode 不会替你停止当前代码

设置 exitCode 只是记录结束时的结果,后面的 JavaScript 仍会执行。因此示例用 if/else 隔开失败和成功分支;在函数中也可以设置后 return,结束当前任务。

process.exit(1) 则会立即结束进程,可能截断尚未完成的异步输出。检查类短脚本通常设置 exitCode 后自然结束。对于仍有网络连接或重复定时器的程序,还需要关闭相关资源;单独设置退出码不会让这些工作停止。


⚠️ 没有处理的错误可能让程序退出

在 Node.js 24 默认配置、没有进程级监听接管时,未捕获异常或未处理的 Promise 拒绝会让进程报错并以失败状态退出。看到这种退出,应回到出错的文件操作、异步任务或事件监听中补上处理,不能只让程序忽略错误继续运行。

排查时可能遇到两个名称:uncaughtException 表示异常没有被捕获,unhandledRejection 表示 Promise 的失败没有及时被处理。它们是进程级通知,不是恢复业务的方法;注册监听会改变默认失败处理,不应为了消除报错就加一个空监听。


❓ 知识问答

Q1:命令行参数与环境变量怎么选?

一次运行临时指定的文件等输入适合参数,部署环境配置适合环境变量。

Q2:设置 exitCode 后为什么还没结束?

可能还有定时器、网络连接或其他活动,设置退出码不会关闭它们。

Q3:修改 process.env 会改变父终端吗?

不会,它影响当前进程环境,以及之后由它创建的子进程默认继承的环境。


🧪 小练习

分别使用 PORT=abc 和 PORT=3000 运行端口检查,确认退出码和后续命令是否执行。再临时注释掉设置 exitCode 的那一行,观察为什么“打印错误”不能替代“报告失败”。

// 请在这里编写代码

🎉 现在可以用自己的例子验证这些用法啦!