如何获取Node.js子进程中执行的已转义命令？

我在Node.js中用spawn执行子进程时，参数会被自动安全转义，比如：

import { spawn } from 'child_process';

const proc = spawn('ls', ['./folder 1']);

但当命令执行失败时，我想输出完整的可直接复制的命令到控制台，方便手动调试。直接用proc.spawnargs.join(' ')的结果无法直接使用，因为空格等特殊字符没被转义：

console.log(proc.spawnargs.join(' '));
// 输出：`ls ./folder 1`
// 复制后执行会把`./folder`和`1`当成两个参数，导致错误

我目前用一个粗糙的正则匹配来处理转义，但想找更优、安全且全面的方案：

args
  .map(arg =>
    /[\t\n\r "#$%&'()*;<=>?\\[`|~]/.test(arg)
      ? `'${arg.replaceAll("'", "\\'")}'`
      : arg
  )
  .join(' ');

更可靠的转义方案 #

针对类Unix系统的Bash Shell，我们可以实现一个更严谨的转义函数，覆盖所有特殊字符的处理，尤其是单引号的转义逻辑：

function escapeShellArg(arg) {
  // 空参数返回空单引号
  if (!arg) return "''";
  // 无特殊字符的参数直接返回
  if (!/[^\w@%+=:,./-]/.test(arg)) return arg;
  // 用单引号包裹参数，内部单引号替换为'\''（Bash中正确的单引号转义方式）
  return `'${arg.replace(/'/g, "'\\''")}'`;
}

function escapeShellCommand(cmd, args) {
  return [cmd, ...args.map(escapeShellArg)].join(' ');
}

// 使用示例
const cmd = 'ls';
const args = ['./folder 1', "file with 'quote'"];
console.log(escapeShellCommand(cmd, args));
// 输出：ls './folder 1' 'file with '\''quote'\'''
// 复制到Bash中可正确执行

方案优势 #

• 全面覆盖特殊字符：包含空格、单引号、双引号、$、反引号等所有Bash特殊字符，避免遗漏
• 正确处理单引号：Bash中单引号内部的单引号无法直接用\转义，必须用'\''的方式拆分处理，这个函数完美解决了这个问题
• 性能高效：仅在必要时才进行转义，无多余计算

如果需要兼容Windows的Cmd或PowerShell，转义逻辑会有所不同，但针对绝大多数类Unix开发环境，上述方案足够安全可靠。

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