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；若不主动读取，缓冲区满后进程会阻塞（尤其在管道链中）。
sc-java-to-ts-interface
下载
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
立即学习“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 返回——这些边界稍不留意，进程就静默卡死，连错误都看不到。
