在Windows下用C++控制CMD执行命令并实时获取返回内容，是写运维工具、自动化脚本时常遇到的需求。单纯用system或WinExec不仅弹控制台窗口，也无法把输出捕获到程序里。正确的做法是通过CreateProcess启动cmd.exe，并利用匿名管道把子进程的标准输入、输出重定向到父进程可控制的句柄，从而实现双向通信。
一、核心原理与API准备
Windows的管道分匿名管道和命名管道，这里用匿名管道就够了。匿名管道由CreatePipe创建，得到读句柄和写句柄。我们要让CMD的子进程把stdin连到管道A的读端，stdout和stderr连到管道B的写端。父进程则持有管道A的写端（用来发命令）和管道B的读端（用来收输出）。
关键点在于SECURITY_ATTRIBUTES里必须把bInheritHandle设为TRUE，并且在CreateProcess时指定STARTUPINFO的hStdInput、hStdOutput、hStdError，同时设置dwFlags包含STARTF_USESTDHANDLES。这样子进程启动后就会用我们给的句柄做标准输入输出，而不是默认的控制台。
1.1 为什么不能直接用控制台函数
像system内部也是起cmd，但它走的是系统默认控制台，父进程拿不到内部句柄。如果强行用FreeConsole再AllocConsole，依然难以稳定捕获流式输出。管道方式从系统层面把字节流导出来，是最干净的做法。
另外，很多人忽略句柄继承问题：如果父进程没设bInheritHandle，子进程根本打不开对应的标准设备，启动会失败或立刻退出。所以安全属性配置是第一步，也是最容易出错的地方。
二、完整实战代码
下面给出一个最小但完整的例子，演示如何创建CMD、写命令、读回显。代码用Visual Studio风格的Win32 API，可直接放进控制台工程编译。
#include <windows.h>
#include <stdio.h>
#include <string.h>
int main() {
SECURITY_ATTRIBUTES sa;
sa.nLength = sizeof(sa);
sa.bInheritHandle = TRUE; // 允许子进程继承句柄
sa.lpSecurityDescriptor = NULL;
HANDLE hReadOut, hWriteOut; // 管道B：子进程写，父进程读
HANDLE hReadIn, hWriteIn; // 管道A：父进程写，子进程读
// 创建输出管道
if (!CreatePipe(&hReadOut, &hWriteOut, &sa, 0)) {
printf("CreatePipe out failedn");
return 1;
}
// 创建输入管道
if (!CreatePipe(&hReadIn, &hWriteIn, &sa, 0)) {
printf("CreatePipe in failedn");
return 1;
}
STARTUPINFO si;
PROCESS_INFORMATION pi;
ZeroMemory(&si, sizeof(si));
ZeroMemory(&pi, sizeof(pi));
si.cb = sizeof(si);
si.dwFlags = STARTF_USESTDHANDLES | STARTF_USESHOWWINDOW;
si.wShowWindow = SW_HIDE; // 不显示CMD窗口
si.hStdInput = hReadIn;
si.hStdOutput = hWriteOut;
si.hStdError = hWriteOut;
// 启动 cmd.exe
if (!CreateProcess(
NULL,
"cmd.exe",
NULL, NULL, TRUE, 0, NULL, NULL, &si, &pi)) {
printf("CreateProcess failed:%dn", GetLastError());
return 1;
}
// 父进程不需要的端要关闭，避免子进程阻塞
CloseHandle(hReadIn);
CloseHandle(hWriteOut);
// 向CMD发送命令
const char* cmd = "echo hello_from_cppn";
DWORD dwWrite;
WriteFile(hWriteIn, cmd, strlen(cmd), &dwWrite, NULL);
// 读取返回
char buf[1024];
DWORD dwRead;
Sleep(200); // 简单等待CMD处理
while (ReadFile(hReadOut, buf, sizeof(buf) - 1, &dwRead, NULL) && dwRead > 0) {
buf[dwRead] = 0;
printf("recv:%s", buf);
break; // 示例只收一次
}
// 退出CMD
const char* exitcmd = "exitn";
WriteFile(hWriteIn, exitcmd, strlen(exitcmd), &dwWrite, NULL);
CloseHandle(hWriteIn);
CloseHandle(hReadOut);
CloseHandle(pi.hProcess);
CloseHandle(pi.hThread);
return 0;
}
2.1 代码要点解析
上面代码中，CreatePipe的四个参数分别是读句柄、写句柄、安全属性、缓冲区大小（0为默认）。注意hReadIn是子进程用的标准输入读端，父进程只保留hWriteIn去写；hWriteOut是子进程的输出写端，父进程留hReadOut去读。这种交叉持有是实现双向管道的基础。
在CreateProcess之前必须关掉不需要的继承端吗？其实不用急着关，但父进程自己用的对立端（比如hReadIn和hWriteOut）如果在父进程里一直开着，会导致ReadFile在子进程退出前不返回EOF，从而卡死。所以示例在创建进程后立刻关掉它们，这是实战避坑的关键一步。
三、避免阻塞与死锁的技巧
直接用ReadFile读管道是阻塞的，如果子进程没输出，父进程就卡在那里。真实交互中常用PeekNamedPipe先探测是否有数据，或者用多线程分别读和写。下面给出用PeekNamedPipe做非阻塞轮询的思路。
DWORD avail = 0;
char buf[1024];
// 探测管道里有没有数据
if (PeekNamedPipe(hReadOut, NULL, 0, NULL, &avail, NULL) && avail > 0) {
DWORD dwRead;
ReadFile(hReadOut, buf, avail > sizeof(buf)-1 ? sizeof(buf)-1 : avail, &dwRead, NULL);
buf[dwRead] = 0;
printf("nonblock recv:%s", buf);
}
3.1 多线程模型更稳健
更专业的写法是单独开一个读线程，循环调用ReadFile阻塞读，主线程负责写命令和逻辑控制。这样无论CMD输出多还是少，都不会让界面或主逻辑假死。记得线程结束时关闭句柄，防止句柄泄漏。
另外，如果执行的命令本身会启动交互式程序（比如python），那也要遵循同样的重定向链，把它们的输入输出继续往管道里接，否则一样会卡住。理解这一点对写复杂自动化尤为重要。
四、常见错误与排查
新手常遇到CreateProcess返回错误码2（文件找不到），一般是命令行字符串写法问题；错误码1816多是句柄继承或配额问题。还有人忘记设STARTF_USESTDHANDLES，导致CMD照常开窗口且不重定向。
| 现象 | 可能原因 | 解决办法 |
|---|---|---|
| CMD窗口闪退 | 句柄未继承或写端没关 | 检查bInheritHandle与CloseHandle时机 |
| ReadFile永远不返回 | 对方写端未关闭 | 发exit并关hWriteIn |
| 中文乱码 | 代码页不一致 | 用chcp 65001或宽字符管道 |
4.1 编码问题补充
默认CMD是GBK，如果C++程序用UTF-8字符串直接写管道，回显可能乱码。可以在发命令前先写"chcp 65001n"切到UTF-8，或者统一用宽字符API如CreateProcessW配合WideCharToMultiByte做转换，保证两边编码对齐。
管道交互本质就是字节流搬运，只要句柄生命周期管清楚、读写节奏控好，C++控制CMD就能像调用本地函数一样顺手，为各类桌面自动化提供底层支撑。
C++CreateProcess命名管道修改时间：2026-07-31 17:15:38