Node.js / 系统课时

读取进程信息

读取进程信息

Node.js 把当前程序的启动方式、环境变量、工作目录和退出状态集中在全局对象 process 中。掌握这些信息后,可以让同一份脚本根据命令行参数和运行环境切换行为,并用明确的退出码告诉 Shell 或 CI 本次执行是否成功。

学习目标

  • 使用 process.argv 与 process.env 读取启动参数和环境变量。
  • 使用 process.cwd() 判断当前工作目录,并区分它与脚本文件所在目录。
  • 使用 process.exitCode 设置成功或失败状态,并在 Shell 中验证退出码。

读取启动参数和环境变量

process.argv 是字符串数组。索引 0 通常是 Node.js 可执行文件路径,索引 1 是当前脚本路径,因此业务参数通常从 process.argv.slice(2) 开始读取。process.env 保存当前进程继承到的环境变量,其值在正常使用时都应按字符串处理。

将下面内容保存为 process-info.js。示例适用于当前常用的 Node.js 20、22 及更高版本,所使用的 process API 在这些版本中保持一致。

js
const args = process.argv.slice(2);
const portArg = args.find((arg) => arg.startsWith('--port='));
const port = portArg?.slice('--port='.length);

console.log('args:', JSON.stringify(args));
console.log('APP_ENV:', process.env.APP_ENV ?? 'development');
console.log('cwd:', process.cwd());

if (!port) {
  console.log('missing --port');
  process.exitCode = 2;
} else {
  console.log('port:', port);
  process.exitCode = 0;
}

在 macOS 或 Linux 的 Bash 中设置环境变量并传入参数:

bash
APP_ENV=staging node process-info.js --port=3000
echo $?

预期输出如下,<PATH> 会随实际工作目录变化:

text
args: ["--port=3000"]
APP_ENV: staging
cwd: <PATH>
port: 3000
0

如果使用 PowerShell,可将第一条命令改为 $env:APP_ENV='staging'; node process-info.js --port=3000,读取方式仍然是 process.env.APP_ENV。

工作目录取决于从哪里启动

process.cwd() 返回启动 Node.js 进程时的当前目录,它不等同于脚本文件所在目录。假设脚本实际位于 <PATH>/tools/process-info.js,先进入项目根目录再执行 node tools/process-info.js --port=3000,那么 process.cwd() 返回项目根目录,而不是 tools 目录。

这个区别会直接影响相对路径。fs.readFileSync('./config.json') 默认会以 process.cwd() 为基准寻找文件,因此命令从不同目录启动时可能得到不同结果。需要读取“项目启动目录下的文件”时可以使用工作目录;需要定位“跟随模块一起发布的文件”时,则应基于模块文件自身的位置构造路径。

可以用下面命令快速确认当前目录:

bash
node -e "console.log(process.cwd())"

预期输出:

text
<PATH>

其中 <PATH> 是执行命令时所在目录的绝对路径,实际值可能不同。

用退出状态告诉外部程序结果

退出码 0 通常表示成功,非零值表示失败。前面的脚本缺少 --port 时把 process.exitCode 设置为 2,Node.js 会在事件循环自然结束后以该状态退出。相比立即调用 process.exit(2),这种方式更适合普通脚本,因为尚未完成的标准输出或异步清理仍有机会结束。

验证失败路径:

bash
node process-info.js
echo $?

预期输出如下,<PATH> 为实际工作目录:

text
args: []
APP_ENV: development
cwd: <PATH>
missing --port
2

在 CI、npm 脚本或 Shell 自动化中,可以直接依据这个非零退出码中止后续步骤。不要只打印“失败”文字却保持退出码为 0,否则调用方通常会把本次执行判断为成功。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

读取进程信息

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通