process.pipe_limit
process.pipe_limit
功能
设置当前 Process 对象 stdout/stderr 管道的未读缓冲上限。适合长时间运行、持续输出进度的子进程，调用方可以按业务吞吐提高上限，例如桌面批处理任务设置为 16MB。
语法
process(program).pipe_limit(bytes)
参数
| 参数 | 类型 | 必填 | 默认值 | 有效范围 | 说明 |
|---|---|---|---|---|---|
| bytes | Int | 是 | 无 | 大于 0，且必须大于等于 BT_PROCESS_PIPE_READ_CHUNK | 单个 stdout 或 stderr 管道允许暂存的未读字节数。 |
返回值
| 类型 | 说明 |
|---|---|
| Process | 返回新的进程构建器。 |
示例
cmd = process('docx_to_img.exe') .pipe_limit(16 * 1024 * 1024) .child() result = cmd.stdout().limit // 输出：16777216 print result
注意事项
- pipe_limit(bytes) 只影响当前 Process 对象，不修改全局环境变量。
- 未调用 pipe_limit(bytes) 时，默认读取 BT_PROCESS_PIPE_LIMIT；未配置环境变量时默认 1048576 字节。
- BT_PROCESS_PIPE_LIMIT 和 pipe_limit(bytes) 限制的是“已从系统管道读出但尚未被 stdout_read/stderr_read 取走”的未读缓冲，不是进程生命周期内的历史累计输出。
- 如果未读缓冲超过上限，stdout_read/stderr_read 会返回运行时错误；后台读取线程仍会继续排空系统管道，避免子进程因为管道写满而卡住。