Node.js调用Inkscape CLI长连接执行命令问题求助

核心问题分析 #

你当前的写法存在两个关键错误：

1. 启动命令未启用**--shell**长连接模式：直接传入SVG路径是一次性导出模式，并没有开启持久化的shell会话
2. child.send()使用场景错误：这个方法是Node.js父子进程的IPC通信接口，而Inkscape的shell模式是通过**标准输入(stdin)**接收命令，并非IPC通道

正确实现步骤 #

1. 启动Inkscape Shell模式 #

用spawn直接启动Inkscape并添加--shell参数，无需启用系统shell（即不设置shell: true，避免额外进程开销）：

const { spawn } = require('child_process');
const inkscapePath = 'path/to/your/inkscape'; // 替换为实际Inkscape可执行文件路径

// 启动Inkscape的shell会话，不传入SVG路径
const inkscapeShell = spawn(inkscapePath, ['--shell']);

// 监听输出用于调试和结果获取
inkscapeShell.stdout.on('data', (data) => {
  console.log(`Inkscape输出: ${data.toString()}`);
});

inkscapeShell.stderr.on('data', (data) => {
  console.error(`Inkscape错误: ${data.toString()}`);
});

inkscapeShell.on('close', (code) => {
  console.log(`Inkscape进程退出，码值: ${code}`);
});

2. 向Shell发送命令 #

通过stdin.write()发送命令，注意每个命令必须以**换行符(\n)**结尾，Inkscape才会执行。示例导出SVG为PNG：

const projectPathSvg = 'path/to/target.svg';
const projectPathPng = 'path/to/output.png';

// 依次发送命令：打开SVG → 设置导出路径 → 执行导出
inkscapeShell.stdin.write(`open: "${projectPathSvg}"\n`);
inkscapeShell.stdin.write(`export-filename: "${projectPathPng}"\n`);
inkscapeShell.stdin.write('export-do\n');

// 如需退出shell会话，发送quit命令
// inkscapeShell.stdin.write('quit\n');

3. 控制命令执行顺序 #

Inkscape的shell会在命令执行完成后输出>提示符，可通过监听该标识来避免命令堆积：

let commandQueue = [];
let isProcessing = false;

inkscapeShell.stdout.on('data', (data) => {
  const output = data.toString().trim();
  // 检测到提示符，执行下一个队列中的命令
  if (output.endsWith('>') && commandQueue.length > 0) {
    isProcessing = false;
    const nextCmd = commandQueue.shift();
    sendCommand(nextCmd);
  }
});

function sendCommand(cmd) {
  if (isProcessing) {
    commandQueue.push(cmd);
    return;
  }
  isProcessing = true;
  inkscapeShell.stdin.write(`${cmd}\n`);
}

// 使用示例
sendCommand(`open: "${projectPathSvg}"`);
sendCommand(`export-filename: "${projectPathPng}"`);
sendCommand('export-do');

常见问题排查 #

• 不设置shell: true无反应：检查Inkscape路径是否正确，是否有执行权限，旧版本可尝试添加--without-gui参数
• 命令无响应：确保每个命令末尾加换行符，路径含空格时用双引号包裹
• 进程意外退出：检查命令格式是否符合Inkscape Shell语法，比如export-do需配合export-filename使用

内容的提问来源于stack exchange，提问作者imv