在Java程序中执行CMD命令（Windows系统命令行指令）是一项常见需求，例如调用系统工具、执行批处理脚本、与外部程序交互等，Java提供了多种方式来实现这一功能，其中最核心的是通过Runtime类和ProcessBuilder类，本文将详细介绍这两种方法的使用场景、代码实现及注意事项，帮助开发者高效、安全地完成CMD命令执行。
使用Runtime类执行CMD命令
Runtime类是Java中与运行时环境交互的入口，每个Java应用程序都有一个Runtime实例，通过Runtime.getRuntime()获取，其exec()方法用于执行外部命令，支持多种重载形式，可传入字符串或字符串数组（推荐字符串数组，避免命令解析错误）。
基本语法与示例
Runtime.exec()的核心方法包括：
exec(String command)：执行简单命令（如dir），但无法正确处理带空格或特殊字符的路径。exec(String[] cmdarray)：推荐方式，将命令和参数拆分为字符串数组，避免解析问题。exec(String command, String[] envp)：可指定环境变量。exec(String[] cmdarray, String[] envp, File dir)：可指定工作目录。
示例1：执行简单命令（列出当前目录文件）
import java.io.BufferedReader;
import java.io.InputStreamReader;
public class RuntimeCmdExample {
public static void main(String[] args) {
try {
// 执行"dir"命令（Windows）
Process process = Runtime.getRuntime().exec("dir");
// 获取命令的标准输出
BufferedReader reader = new BufferedReader(
new InputStreamReader(process.getInputStream(), "GBK") // Windows默认GBK编码
);
String line;
System.out.println("命令输出：");
while ((line = reader.readLine()) != null) {
System.out.println(line);
}
// 等待命令执行完成，获取退出码
int exitCode = process.waitFor();
System.out.println("退出码: " + exitCode);
} catch (Exception e) {
e.printStackTrace();
}
}
}
处理带空格或特殊字符的命令
若命令路径包含空格（如C:Program Filesapptest.exe），直接使用字符串形式会导致解析错误，必须拆分为数组：
// 错误方式：Runtime.getRuntime().exec("C:\Program Files\app\test.exe -param");
// 正确方式：拆分为数组
String[] cmd = {
"cmd", "/c", "C:\Program Files\app\test.exe", "-param"
};
Process process = Runtime.getRuntime().exec(cmd);
Runtime.exec()的注意事项
- 缓冲区死锁：子进程的标准输出（
InputStream）和错误输出（ErrorStream）缓冲区有限，若不及时读取，可能导致子进程阻塞，进而使Java进程挂起，解决方案：使用多线程分别读取输出流和错误流（见下方完整示例）。 - 编码问题：Windows命令行默认GBK编码，需指定
InputStreamReader的编码为"GBK"，避免中文乱码。 - 阻塞问题：
process.waitFor()会阻塞当前线程，直到子进程结束，若需异步执行，可结合Thread或CompletableFuture。
使用ProcessBuilder类执行CMD命令
ProcessBuilder是Java 5引入的类，比Runtime更灵活，支持命令参数列表、环境变量管理、工作目录设置、流重定向等功能，是执行复杂命令的首选。
基本语法与示例
ProcessBuilder通过构造方法传入命令列表（字符串数组），调用start()启动进程。
示例2：执行带参数的命令（ping测试）
import java.io.BufferedReader;
import java.io.File;
import java.io.InputStreamReader;
public class ProcessBuilderExample {
public static void main(String[] args) {
try {
// 构建命令：ping -n 4 127.0.0.1
ProcessBuilder pb = new ProcessBuilder("cmd", "/c", "ping", "-n", "4", "127.0.0.1");
// 设置工作目录（可选）
pb.directory(new File("C:\"));
// 启动进程
Process process = pb.start();
// 读取标准输出
BufferedReader reader = new BufferedReader(
new InputStreamReader(process.getInputStream(), "GBK")
);
String line;
System.out.println("Ping输出：");
while ((line = reader.readLine()) != null) {
System.out.println(line);
}
// 读取错误输出（可选）
BufferedReader errorReader = new BufferedReader(
new InputStreamReader(process.getErrorStream(), "GBK")
);
System.out.println("错误输出：");
while ((line = errorReader.readLine()) != null) {
System.out.println(line);
}
int exitCode = process.waitFor();
System.out.println("退出码: " + exitCode);
} catch (Exception e) {
e.printStackTrace();
}
}
}
ProcessBuilder的高级功能
- 环境变量管理：通过
pb.environment()可获取或设置环境变量（如添加Path路径）。ProcessBuilder pb = new ProcessBuilder("myApp.exe"); pb.environment().put("MY_VAR", "value"); // 设置自定义环境变量 - 流重定向：可将输出重定向到文件或合并输出流与错误流。
pb.redirectOutput(new File("output.txt")); // 标准输出重定向到文件 pb.redirectErrorStream(true); // 合并错误流到标准输出
ProcessBuilder的优势对比
| 特性 | Runtime.exec() | ProcessBuilder |
|---|---|---|
| 命令参数处理 | 需手动处理字符串解析（易出错） | 直接传入字符串数组，解析准确 |
| 环境变量管理 | 需额外构造数组传递 | 通过environment()方法灵活修改 |
| 流重定向 | 需手动操作Process的流 |
提供redirectOutput()等方法，更简洁 |
| 工作目录设置 | 需额外方法参数 | 通过directory()方法设置 |
| 异常处理 | 抛出IOException |
抛出IOException，但更易结合流操作 |
完整示例：避免缓冲区死锁的异步读取
无论是Runtime还是ProcessBuilder，核心问题都是及时读取子进程的输出流和错误流，避免阻塞，以下是一个完整示例，使用多线程分别读取输出和错误：
import java.io.BufferedReader;
import java.io.InputStream;
import java.io.InputStreamReader;
public class SafeCmdExecution {
public static void main(String[] args) {
String[] cmd = {"cmd", "/c", "ping", "-n", "4", "127.0.0.1"};
try {
ProcessBuilder pb = new ProcessBuilder(cmd);
Process process = pb.start();
// 启动线程读取标准输出
Thread outputThread = new Thread(() -> {
try (BufferedReader reader = new BufferedReader(
new InputStreamReader(process.getInputStream(), "GBK"))) {
String line;
while ((line = reader.readLine()) != null) {
System.out.println("[输出] " + line);
}
} catch (Exception e) {
e.printStackTrace();
}
});
// 启动线程读取错误输出
Thread errorThread = new Thread(() -> {
try (BufferedReader reader = new BufferedReader(
new InputStreamReader(process.getErrorStream(), "GBK"))) {
String line;
while ((line = reader.readLine()) != null) {
System.err.println("[错误] " + line);
}
} catch (Exception e) {
e.printStackTrace();
}
});
outputThread.start();
errorThread.start();
// 等待命令执行完成
int exitCode = process.waitFor();
outputThread.join();
errorThread.join();
System.out.println("命令执行完成，退出码: " + exitCode);
} catch (Exception e) {
e.printStackTrace();
}
}
}
Java执行CMD命令的核心是Runtime.exec()和ProcessBuilder，其中ProcessBuilder功能更全面，推荐优先使用，关键注意事项包括：
- 使用字符串数组传递命令参数,避免解析错误；
- 通过多线程分别读取输出流和错误流,防止缓冲区死锁；
- 指定正确的字符编码（如Windows的GBK），避免乱码；
- 合理处理异常和退出码,确保程序健壮性。
相关问答FAQs
Q1：执行CMD命令时如何避免中文乱码？
A：Windows命令行的默认编码是GBK，因此在读取InputStream时，需显式指定编码为"GBK"。
BufferedReader reader = new BufferedReader(
new InputStreamReader(process.getInputStream(), "GBK")
);
若使用UTF-8编码，可能导致中文显示为乱码，确保命令行工具本身支持GBK编码（如type、dir等内置命令无需额外处理）。
Q2：如何获取CMD命令的退出码（Exit Code）？
A：Process类提供了exitValue()方法，可在命令执行完成后获取退出码（0表示成功，非0表示失败），需注意：exitValue()需在进程结束后调用，否则会抛出IllegalThreadStateException，推荐结合waitFor()使用：
Process process = Runtime.getRuntime().exec("cmd /c exit 1"); // 模拟退出码1
process.waitFor(); // 等待进程结束
int exitCode = process.exitValue(); // 获取退出码（1）
System.out.println("退出码: " + exitCode);
通过退出码可判断命令执行是否成功,例如批处理脚本中的%ERRORLEVEL%对应Java中的exitValue()。
原创文章，发布者：酷番叔，转转请注明出处：https://cloud.kd.cn/ask/17936.html
