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 在这些版本中保持一致。
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 中设置环境变量并传入参数:
APP_ENV=staging node process-info.js --port=3000
echo $?预期输出如下,<PATH> 会随实际工作目录变化:
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() 为基准寻找文件,因此命令从不同目录启动时可能得到不同结果。需要读取“项目启动目录下的文件”时可以使用工作目录;需要定位“跟随模块一起发布的文件”时,则应基于模块文件自身的位置构造路径。
可以用下面命令快速确认当前目录:
node -e "console.log(process.cwd())"预期输出:
<PATH>其中 <PATH> 是执行命令时所在目录的绝对路径,实际值可能不同。
用退出状态告诉外部程序结果
退出码 0 通常表示成功,非零值表示失败。前面的脚本缺少 --port 时把 process.exitCode 设置为 2,Node.js 会在事件循环自然结束后以该状态退出。相比立即调用 process.exit(2),这种方式更适合普通脚本,因为尚未完成的标准输出或异步清理仍有机会结束。
验证失败路径:
node process-info.js
echo $?预期输出如下,<PATH> 为实际工作目录:
args: []
APP_ENV: development
cwd: <PATH>
missing --port
2在 CI、npm 脚本或 Shell 自动化中,可以直接依据这个非零退出码中止后续步骤。不要只打印“失败”文字却保持退出码为 0,否则调用方通常会把本次执行判断为成功。