Node.js process

在 Node.js 中，process 是一个全局对象 （无需 require 即可直接使用），它提供了当前 Node.js 进程的运行时信息与控制能力。你列出的这些属性和方法，恰好覆盖了进程操作的输入输出 、事件监听 、环境配置 、系统信息 和生命周期控制五大核心维度。

下面为你分层拆解，包含代码示例和深度注意事项：

1. 标准输入输出流（I/O）

这是进程与终端/用户交互的管道。

• process.stdin（标准输入） ：一个可读流（Readable Stream），用于接收程序运行时输入的数据（如键盘输入）。

  • 默认状态 ：默认是暂停的（paused），需要恢复 resume() 或监听 data 事件才能读取。

  • 示例（交互式问答）：

    javascript

    process.stdin.setEncoding('utf-8');
    process.stdin.on('data', (chunk) => {
        console.log(`你输入了: ${chunk.trim()}`);
        // 通常输入一次后退出，防止一直监听
        process.exit(0);
    });

• process.stdout（标准输出） ：一个可写流 （Writable Stream），用于打印正常信息。console.log 底层就是调用了 process.stdout.write。

  • 示例 ：process.stdout.write('Hello World\n');

• process.stderr（标准错误） ：一个可写流 ，专门用于输出错误信息。它与 stdout 分开，便于日志重定向（例如将错误单独写入错误日志文件）。

  • 示例 ：process.stderr.write('Fatal Error!');（console.error 底层调用此方法）。

---

2. 进程生命周期与事件监听（process.on）

用于监听进程的内置事件，通常在发生异常或退出时进行清理工作（如关闭数据库连接）。

• 核心事件：

  • exit：进程即将结束时触发（此时不能执行异步操作，事件循环已结束）。

  • beforeExit：事件循环为空时触发，如果在此监听中放入新任务，进程会继续运行。

  • uncaughtException：捕获未被 try/catch 包裹的异常（警告：官方不推荐用它恢复进程，更建议记录日志后退出，防止状态不一致）。

  • SIGINT：监听 Ctrl+C 信号。

• 示例（进程退出前清理资源）：

  javascript

  process.on('exit', (code) => {
      // 只能执行同步操作
      console.log(`进程即将退出，退出码: ${code}`);
  });
  
  process.on('uncaughtException', (err) => {
      console.error('捕获到未处理的异常:', err);
      process.exit(1); // 手动退出
  });

---

3. 环境与配置信息（env 与 argv）

• process.env（环境变量）：返回一个包含用户操作系统环境变量的对象。

  • 实战用途 ：区分开发/生产环境（如 NODE_ENV）、读取数据库密码或 API Key（避免硬编码在代码中）。

  • 示例：

    bash

    # 启动时注入变量
    NODE_ENV=production PORT=3000 node app.js

    javascript

    const env = process.env.NODE_ENV || 'development';
    const port = process.env.PORT || 8080;
    console.log(`当前环境: ${env}, 端口: ${port}`);

• process.argv（命令行参数）：返回一个数组，包含启动 Node.js 进程时的命令行参数。

  • 索引解析：

    • argv[0]：Node.js 的可执行文件路径。

    • argv[1]：当前执行的 JavaScript 文件路径。

    • argv[2] 及以后：用户传入的自定义参数。

  • 示例：

    bash

    node app.js --name John --age 25

    javascript

    // 输出: ['/usr/bin/node', '/path/app.js', '--name', 'John', '--age', '25']
    console.log(process.argv);
    // 简单解析（通常推荐使用 yargs 或 commander 库）
    const args = process.argv.slice(2);

---

4. 底层系统信息（arch 与 platform）

• process.arch ：返回 Node.js 编译时对应的 CPU 架构。常用值：'x64'、'arm64'、'ia32'。用于判断是否要下载特定架构的二进制依赖包。

• process.platform ：返回运行时的操作系统平台。常用值：'linux'、'win32'（注意 Windows 是 win32，即使 64 位）、'darwin'（macOS）。

• 实战示例（跨平台兼容处理）：

  javascript

  if (process.platform === 'win32') {
      // 执行 Windows 下的批处理命令
      console.log('检测到 Windows 系统');
  } else {
      // 执行 Unix/Linux 下的 shell 命令
      console.log('检测到 Unix 系系统');
  }

---

5. 进程退出（process.exit）

• process.exit([code]) ：通知 Node.js 强制终止进程。code 默认是 0（代表成功），非 0（如 1）代表异常退出。

• ⚠️ 深度警告：

  • 直接调用 process.exit() 会立即终止，即使还有异步操作（如数据库写入、文件关闭）未完成。它会粗暴地中断事件循环。

  • 优雅退出策略 ：若需要等待异步任务完成，应使用 process.on('exit') 或先关闭资源，再调用 process.exit。更推荐的方式是让事件循环自然清空 ，进程会自动退出，无需显式调用 exit。

---

总结速查表

属性/方法	类型	核心用途
stdin	可读流	读取用户输入
stdout / stderr	可写流	打印标准日志 / 错误信息
on	方法	监听进程退出、异常、信号等事件
env	对象	读取系统环境变量（配置）
argv	数组	获取命令行启动参数
arch	字符串	判断 CPU 架构（x64/arm64）
platform	字符串	判断操作系统（linux/win32/darwin）
exit	方法	强制终止进程（谨慎使用）

如果你正在编写 CLI（命令行工具）工具，建议将 process.argv 和 process.env 结合使用，并利用 stdout/stderr 输出美化后的命令行界面。如果涉及复杂的进程管理，还可以进一步研究 child_process 模块（子进程）。