Node.js 怎么用 child_process 执行外部命令并获取输出？

Question

仓乃文 · Accepted Answer

需要在 Node.js 中调用系统命令（git、docker、python 脚本等）并获取输出。child_process 模块提供 spawn、exec、execFile 三种方式，spawn 适合长时间运行的命令和大数据量，exec 适合简单命令和需要完整输出的场景。

exec 执行命令获取完整输出：
```javascript
const { exec } = require("child_process");

exec("git log --oneline -5", (error, stdout, stderr) => {
  if (error) {
    console.error("执行失败:", error.message);
    return;
  }
  console.log(stdout);
});
```

spawn 流式处理大输出：
```javascript
const { spawn } = require("child_process");

Promise 包装：
```javascript
const { exec } = require("child_process");
const util = require("util");
const execAsync = util.promisify(exec);

async function getGitStatus() {
  const { stdout } = await execAsync("git status --porcelain");
  return stdout.split("
").filter(Boolean);
}
```

补充说明：
- exec 缓冲全部输出，默认 maxBuffer 200KB，大输出用 spawn
- execFile 直接执行文件不经过 shell，比 exec 更安全
- spawn 是底层 API，适合长时间运行的进程（如 ffmpeg 转码）
- 注意命令注入风险，不要直接拼接用户输入到命令字符串
- 跨平台用 cross-env 等工具处理环境变量差异