ProcessBuilder不能直接执行含管道、重定向或通配符的shell命令,因其不经过shell解析;需显式调用/bin/sh -c(Linux/macOS)或cmd /c(Windows),并将完整命令作为单个字符串参数传入,同时注意及时读取输入输出流以防阻塞。

ProcessBuilder 不能直接执行带管道、重定向或通配符的 shell 命令,它只调用程序本身,不经过 shell 解析。
为什么 ProcessBuilder 执行 ls *.java | wc -l 会报错或没输出
因为 ProcessBuilder 默认不启动 shell(如 /bin/sh 或 cmd.exe),*、|、> 这些符号不会被展开或解析——它们只是普通字符串参数,传给 ls 后会被当作字面文件名处理。
- 错误现象:
IOException: Cannot run program "ls *.java | wc -l": error=2, No such file or directory - 根本原因:操作系统找不到名为
"ls *.java | wc -l"的可执行文件 - 正确做法:显式调用 shell,并把整条命令作为其参数(注意平台差异)
跨平台调用 shell 执行复合命令的写法
Linux/macOS 下用 /bin/sh -c,Windows 下用 cmd /c。命令字符串必须作为单个参数传给 -c 或 /c,否则 shell 不会解析。
// Linux/macOS
ProcessBuilder pb = new ProcessBuilder("/bin/sh", "-c", "ls *.java | wc -l");
// Windows
ProcessBuilder pb = new ProcessBuilder("cmd", "/c", "dir *.java /b | find /c \":\"");
// ⚠️ 错误示范(参数拆开会导致 shell 接收不到完整命令)
// new ProcessBuilder("/bin/sh", "-c", "ls", "*.java", "|", "wc", "-l") ← 不生效
-
ProcessBuilder构造时,每个字符串是一个独立参数,不能“假装”是 shell 命令行 -
-c后面的整个字符串才是 shell 要执行的命令体,必须保持为一个String - Windows 中双引号需转义(如
"find /c \"\\\"\""),避免被 Java 字符串或 cmd 误截断
获取命令输出和错误流的常见陷阱
默认情况下,子进程的 stderr 是独立管道,不自动合并到 stdout;若不主动读取,缓冲区满后进程会阻塞(尤其在管道链中)。
立即学习“Java免费学习笔记(深入)”;
- 务必调用
pb.inheritIO()(仅调试用)或分别获取process.getInputStream()和process.getErrorStream()并及时读取 - 不要只读
stdout忽略stderr,否则像ls: cannot access *.java: No such file这类错误会卡住进程 - 推荐用
process.waitFor(30, TimeUnit.SECONDS)加超时,防止挂起 - 若需实时日志,可用两个线程分别消费
stdout和stderr,或用redirectErrorStream(true)合并
环境变量与工作目录的设置影响很大
ProcessBuilder 默认继承父进程环境,但某些命令依赖特定环境(如 PATH、HOME、自定义变量),或要求在指定目录下运行(比如相对路径脚本)。
- 用
pb.directory(new File("/tmp"))显式设工作目录,避免路径解析错误 - 修改环境变量要通过
pb.environment().put("KEY", "value"),不是构造时传入 - 注意:
environment()返回的是引用,直接clear()会清空全部继承变量,慎用 - 某些安全策略(如容器、JVM 安全管理器)可能限制环境变量传递或路径访问
真正难的不是拼出那几行代码,而是判断哪部分该由 Java 处理、哪部分必须甩给 shell、以及什么时候该自己读流而不是等着 waitFor 返回——这些边界稍不留意,进程就静默卡死,连错误都看不到。










