Java执行CMD/Shell命令全攻略

本文深入剖析了Java中执行CMD/Shell命令的核心难点与最佳实践，直击Runtime.exec和ProcessBuilder常见失效场景——从路径错误、命令未正确拆解、环境变量缺失，到流阻塞导致进程卡死、退出码误判、跨平台行为不一致等顽疾；强调必须用字符串数组传参、显式调用shell（如cmd /c或/bin/sh -c）、及时消费输入输出流、合理设置超时与工作目录，并指出“成功”的定义需结合退出码、stderr内容和业务关键词综合判断，而非依赖单一指标，为开发者提供了一套兼顾健壮性、可维护性与平台兼容性的落地解决方案。

Runtime.exec 执行命令失败，输出为空或报错 java.io.IOException: Cannot run program

根本原因通常是路径没找对、命令没拆解、或环境变量缺失。Java 的 Runtime.exec 不走 shell 解析器（比如 bash 或 cmd.exe），它直接 fork 进程，所以不支持重定向符号（>、|）、通配符（*）、变量展开（$HOME）这些 shell 特性。

常见错误现象：Runtime.exec("ls -la /tmp | grep java") 直接抛异常；或执行 ping www.example.com 在 Windows 上失败，因为找不到 ping——其实是没加 .exe 后缀，或者没指定完整路径。

• 用字符串数组代替单字符串传参：Runtime.getRuntime().exec(new String[]{"ping", "-n", "1", "localhost"})，避免空格分割歧义
• Windows 下建议显式调用 shell：Runtime.getRuntime().exec(new String[]{"cmd", "/c", "dir"})；macOS/Linux 用 new String[]{"/bin/sh", "-c", "ls | wc -l"}
• 别依赖 PATH：写绝对路径更稳，比如 /usr/bin/python3 而非 python3
• 记得调用 process.waitFor() 等待结束，否则可能读不到完整输出

ProcessBuilder 启动命令后卡住，waitFor() 一直不返回

这是最典型的流阻塞问题：子进程 stdout/stderr 缓冲区满了，但 Java 没及时读走，导致子进程挂起。尤其在执行像 mvn compile、git log 这类输出量大的命令时必现。

使用场景：需要稳定控制命令生命周期、设置工作目录、环境变量，或执行多步骤脚本。

• 必须同时消费 process.getInputStream() 和 process.getErrorStream()，哪怕只是丢弃：new Thread(() -> consumeStream(process.getInputStream())).start()
• 用 redirectErrorStream(true) 合并流，简化处理逻辑，但注意错误和输出混在一起了
• 设置超时更安全：process.waitFor(30, TimeUnit.SECONDS)，避免无限等待
• directory(new File("/path")) 比在命令里写 cd /path && xxx 可靠得多，后者依赖 shell 且易出错

获取命令真实退出码总是 0，明明执行失败了

很多命令靠 stderr 输出错误信息但返回码仍是 0（比如某些 Python 脚本、自定义 shell 工具），或者反过来：命令失败但 Java 拿不到非零码（因为被 shell 包了一层却没透传）。不能只信 process.exitValue()。

参数差异：exitValue() 只能在进程结束后调用，否则抛 IllegalThreadStateException；而 waitFor() 返回值才是真正的退出码。

• 永远用 int exitCode = process.waitFor(); 获取退出码，而不是 process.exitValue()
• 检查 stderr 内容比只看退出码更靠谱，比如匹配 "ERROR"、"Traceback"、"Command not found"
• 如果用 /bin/sh -c 包裹命令，确保用 $? 透传内层命令的退出码，例如：/bin/sh -c 'some_cmd; exit $?'
• 某些工具（如 docker run --rm）在容器启动失败时可能返回 125/126/127，要查清含义，别一概当“失败”

跨平台兼容性差：同一段代码在 Windows 和 Linux 行为不一致

根本差异不在 Java，而在底层 shell 行为、路径分隔符、换行符、甚至命令是否存在。比如 del 和 rm、cls 和 clear、C:\ 和 /home/。

性能影响不大，但维护成本高：硬编码命令会快速变成技术债。

• 优先封装成独立脚本（deploy.sh / deploy.bat），Java 只调用统一入口名，由 OS 选对应版本
• 用 System.getProperty("os.name") 做轻量适配，但别写太多分支逻辑，容易漏测
• 路径拼接一律用 Paths.get("a", "b", "c").toAbsolutePath()，别手动拼 "a/b/c" 或 "a\\b\\c"
• 换行符统一用 \n 处理输出，不要假设 \r\n，InputStream 读出来就是原始字节

真正麻烦的不是怎么调用，而是怎么判断“命令到底算成功”。stderr 有没有内容？输出里有没有关键词？退出码是否在预期范围内？这些逻辑得根据具体命令来定，没法一套模板打天下。

理论要掌握，实操不能落！以上关于《Java执行CMD/Shell命令全攻略》的详细介绍，大家都掌握了吧！如果想要继续提升自己的能力，那么就来关注golang学习网公众号吧！