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:
PORT=3000
用 process.env.PORT 读取端口配置:
console.log(process.env.PORT)
执行 node --env-file=.env process-demo.mjs,输出 3000。这里的值是字符串,不是数字;--env-file 是 Node.js 24.19.0 的内置文件加载选项,不需要安装包。
如果不加载文件,且系统也没有提供 PORT,结果是 undefined。.env 放在目录里不会自动生效;系统已有同名环境变量时通常优先使用系统值。
配置需要转换并验证
读取成功不代表输入合法。将脚本替换为:
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:
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() 的返回值 |
|---|---|---|
/work | node demo/process-demo.mjs | /work |
/work/demo | node 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:
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=3000 | 0 | 输出“端口检查通过”,然后输出“允许执行下一步” |
PORT=abc | 1 | 输出端口错误,不执行后面的 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 的那一行,观察为什么“打印错误”不能替代“报告失败”。
// 请在这里编写代码
🎉 现在可以用自己的例子验证这些用法啦!
