child_process.exec
是 Node.js 的一个核心模块,它允许你异步地执行系统命令,并将执行结果以字符串的形式返回。这个功能特别有用,当你需要从 Node.js 应用中调用外部程序或脚本时。
基本用法
child_process.exec
方法的基本语法如下:
const { exec } = require('child_process');
exec(command[, options][, callback])
command
:要运行的命令,以字符串的形式提供。options
(可选):一个对象,可以包含如cwd
(子进程的当前工作目录)、env
(环境变量)、encoding
(字符编码,默认为'utf8'
)等属性。callback
(可选):当进程结束时被调用,它接收三个参数:error
、stdout
(标准输出)、stderr
(标准错误输出)。
代码实例
以下是一个使用 child_process.exec
的简单例子,它执行 ls
命令(列出当前目录下的文件和文件夹),并打印出输出结果。
const { exec } = require('child_process');
exec('ls', (error, stdout, stderr) => {
if (error) {
console.error(`exec error: ${error}`);
return;
}
console.log(`stdout: ${stdout}`);
if (stderr) {
console.log(`stderr: ${stderr}`);
}
});
高级用法
你也可以通过提供 options
对象来定制 exec
方法的行为。比如,你可以设置 maxBuffer
选项来限制 stdout 或 stderr 的最大缓冲大小,防止因为输出过多而导致的程序崩溃。
exec('ls -lh', { maxBuffer: 1024*100 }, (error, stdout, stderr) => {
if (error) {
console.error(`exec error: ${error}`);
return;
}
console.log(`stdout: ${stdout}`);
if (stderr) {
console.log(`stderr: ${stderr}`);
}
});
注意事项
exec
方法适用于执行短生命周期的任务,因为它会将输出缓存起来,直到子进程结束。如果你预期会有大量的输出,使用child_process.spawn
可能更为合适,因为它以流的形式处理数据。- 为了安全起见,当你执行的命令包含用户输入时,务必小心,避免注入攻击。
child_process.exec
是 Node.js 中与操作系统交互的强大工具,通过它,你可以轻松地在你的应用中集成外部程序或脚本。