Node.js child_process exec调用CMD时特殊字符编码异常求助
问题核心原因
这个问题和Node.js exec方法本身的encoding配置没有关系,本质是Windows CMD全链路的编码不匹配:
- Node.js默认以UTF-8编码将待执行的命令字符串传给CMD,但CMD默认的输入编码是系统OEM代码页(比如欧美系统多为437代码页,简体中文系统多为936/GBK),根本无法识别UTF-8编码的特殊字符(比如示例中的
ø,对应UTF-8字节为0xC3 0xB8,在CMD默认代码页中会被判定为无效字符直接丢弃,最终echo时就丢失了该字符,输出只剩o) - 就算CMD正确识别了命令字符,其输出的字节流编码也和Node.js默认期望的UTF-8不匹配,若直接解码会出现乱码
可落地解决方案
临时为单条命令切换UTF-8编码
最稳妥的方式是在待执行的命令开头,先执行chcp 65001 >nul命令,将CMD当前会话的代码页临时切换为UTF-8,通过>nul屏蔽chcp命令本身的输出干扰,再执行目标业务命令。
修正后的可运行示例:
const { exec } = require('child_process'); // 先切换当前CMD会话编码到UTF-8,再执行echo命令 exec('chcp 65001 >nul && echo oø', { encoding: 'buffer' }, (err, stdout, stderr) => { if (err) throw err; // 明确以UTF-8解码原始输出Buffer,避免默认编码匹配错误 console.log(stdout.toString('utf8')); });
此时拿到的原始Buffer会包含ø对应的正确UTF-8字节,不再是之前的6f 6f,解码后即可拿到预期的oø输出。
为所有子进程命令全局配置UTF-8编码
如果不想每次在业务命令前拼接chcp逻辑,可以直接修改exec配置中的shell参数,让CMD启动时自动先执行编码切换命令,对所有在该配置下执行的命令全局生效,示例:
const { exec } = require('child_process'); exec('echo oø', { encoding: 'buffer', // 所有通过该配置调用的命令,启动时都会先切换为UTF-8代码页 shell: 'cmd.exe /c chcp 65001 >nul &&' }, (err, stdout, stderr) => { if (err) throw err; console.log(stdout.toString('utf8')); });
注意事项
- 不要试图仅通过调整
out.toString()的编码参数解决问题:如果CMD在解析命令阶段已经丢弃了特殊字符,拿到的输出Buffer本身就是错误的,无论用什么编码解码都无法还原正确内容- 全链路编码必须统一:要保证Node.js传命令的编码、CMD解析命令的编码、CMD输出的编码、Node.js解码输出的编码四者完全一致,选UTF-8作为统一编码是兼容性最高的方案
- 若使用PowerShell作为子进程shell,逻辑完全一致,仅需要将chcp切换代码页的命令替换为PowerShell对应的编码切换语法即可
内容的提问来源于stack exchange,提问作者Mathias Andersen
相关产品推荐
相关产品推荐

