怎么在 Node.js 中执行 Shell 代码比较合适？

在 Node.js 里跑 Shell 命令，官方提供的 child_process 模块是标准做法，但选对方法比能跑更重要，生产环境建议优先使用 execFile 或 spawn 并关闭 shell 选项。

先说结论：优先使用 execFile 或 spawn 方法，避免直接将用户输入拼接到 exec 命令中。

• 适合：需要调用系统命令、脚本或二进制文件的场景
• 优先做：参数与命令分开传递，不要拼接字符串
• 再验证：检查退出码和非零错误处理

核心代码示例

以下是直接可用的代码片段，涵盖同步回调、流式处理及 Promise 封装，复制后修改命令和参数即可。

1. execFile 基础用法

const { execFile } = require('child_process');execFile('ls', ['-l', '/home'], (error, stdout, stderr) => {if (error) {console.error(`执行出错：${error}`);return;}console.log(`输出：${stdout}`);
});

2. spawn 流式处理

适合处理大量输出或长时间运行的进程，避免缓冲区溢出。

const { spawn } = require('child_process');const child = spawn('ls', ['-l']);child.stdout.on('data', (data) => {console.log(`输出：${data}`);
});child.stderr.on('data', (data) => {console.error(`错误：${data}`);
});child.on('close', (code) => {console.log(`子进程退出，退出码 ${code}`);
});

3. Promise 封装 (async/await)

适合现代异步流程，配合 util.promisify 使用。

const { execFile } = require('child_process');
const util = require('util');
const execFileAsync = util.promisify(execFile);async function runCommand() {try {const { stdout } = await execFileAsync('ls', ['-l']);console.log(stdout);} catch (error) {console.error('执行失败', error);}
}runCommand();

为什么会这样

Node.js 的 child_process 模块提供了多种方法，主要区别在于是否启动 Shell 进程。exec 方法会启动/bin/sh 来执行命令，这意味着支持管道和通配符，但也带来了 Shell 注入风险。execFile 和 spawn 默认不启动 Shell，直接执行二进制文件，安全性更高，且开销更小。

分步处理

1. 引入模块：使用 require('child_process') 或 import 导入。
2. 选择方法：如果需要 Shell 特性（如管道）才用 exec，否则用 execFile 或 spawn。
3. 传递参数：命令和参数数组分开写，例如 ['arg1', 'arg2']，不要拼成 'cmd arg1 arg2'。
4. 错误处理：必须检查回调或 Promise 中的 error 对象，以及进程的 exit code。

怎么验证是否生效

1. 保存文件：将上述任一示例代码保存为 script.js。
2. 正常运行：终端执行 node script.js，检查控制台是否打印预期文件列表。
3. 异常测试：将代码中的路径参数改为不存在的目录（如 /not_exist），确认捕获到 error 对象且进程退出码非 0。
4. 性能观察：对于大量输出场景，使用 spawn 示例观察内存占用是否稳定，确认无缓冲区溢出。

常见坑

• Shell 注入：永远不要信任用户输入，避免 exec(`cmd ${userInput}`) 这种写法。
• 缓冲区溢出：exec 有 maxBuffer 限制，输出过大进程会崩溃，大输出请用 spawn。
• 跨平台路径：Windows 和 Linux 的命令和路径分隔符不同，硬编码命令会导致兼容性问题。
• 环境变量：子进程可能继承不到父进程的环境变量，必要时需手动配置 env 选项。

参考来源

• Node.js 官方文档 - Child Process 模块：https://nodejs.org/api/child_process.html

原文链接：https://www.zjcp.cc/ask/11013.html