要点
- Python をパイプにつなぐと、1行目は1.5秒待ってから2行目と一緒に届いた。端末では1行目がすぐ届いた(出典: 自社の実測・2026-11-06)
- Python の公式ドキュメントには、対話的でないとき stdout はブロックバッファになると書いてある(出典: https://docs.python.org/3/library/sys.html )
-uかPYTHONUNBUFFERED=1を付けると、パイプでも1行目がすぐ届いた(出典: 自社の実測・2026-11-06)- Node と Go は、端末でもパイプでも1行目がすぐ届いた(出典: 自社の実測・2026-11-06)
- パイプやファイルにつないだ Python を
os._exit(0)やkill -9で終わらせると、print した行が0バイトで消えた。print(..., flush=True)した行はos._exit(0)の後も残った(出典: 自社の実測・2026-11-06)
何が困るのか:端末では出るのに、パイプの先では出ない
Python のスクリプトを端末で動かすと、print した行はすぐ画面に出ます。同じスクリプトを | tee log.txt でつないだり、cron やコンテナのログに流したりすると、行がまとめて遅れて出てきます。途中で落ちたときには、最後の数行がログに残りません。
この記事でいう Python の print バッファリングとは、print した文字列がいったん stdout のバッファに溜まり、書き出されるまで読み手に届かないことを指す。
確かめたかったのは次の3つです。
- 1行出力して1.5秒待ち、もう1行出力するプログラムを、端末(TTY)とパイプにつないだとき、1行目が読み手に届く時刻は同じか
- Python・Node・Go で違いはあるか
- 強制終了したとき、出力は残るか
測った環境は macOS(APFS)で、python3 -V は Python 3.9.0、node -v は v22.23.4、go version は go version go1.26.2 darwin/arm64 でした。端末の代わりに疑似端末(Python の pty.openpty())を使いました。時刻は読み手が起動してからの秒数(0.1秒単位)で、起動にかかる時間も含みます。見るのは秒数そのものではなく、「1行目と2行目が別々に届いたか」です。
3つの言語に同じ動きをさせました。
import time
print('first');time.sleep(1.5);print('second')
console.log('first');setTimeout(()=>console.log('second'),1500);
package main
import ("fmt";"time")
func main(){fmt.Println("first");time.Sleep(1500*time.Millisecond);fmt.Println("second")}
出典: 自社の実測(2026-11-06)
公式はどう書いているか
Python の公式ドキュメント「sys」は、stdout について次のように書いています。
"When interactive, the stdout stream is line-buffered. Otherwise, it is block-buffered like regular text files. The stderr stream is line-buffered in both cases. You can make both streams unbuffered by passing the -u command-line option or setting the PYTHONUNBUFFERED environment variable."
出典: https://docs.python.org/3/library/sys.html (取得日 2026-11-05)
対話的なとき(端末につないだとき)は行単位で書き出し、そうでないとき(パイプやファイル)は普通のテキストファイルと同じくブロック単位で溜める、という意味です。-u と PYTHONUNBUFFERED で、stdout と stderr の両方をバッファなしにできるとも書かれています。PYTHONUNBUFFERED は、設定すると Python の stdout と stderr をバッファなしにする環境変数のことだ。
print 関数には flush という引数があり、既定は False です。
"print(*objects, sep=' ', end='\n', file=None, flush=False)"
出典: https://docs.python.org/3/library/functions.html (取得日 2026-11-05)
Node.js の公式ドキュメント「process」の A note on process I/O には、パイプについて次の一文があります。
"Pipes (and sockets): synchronous on Windows, asynchronous on POSIX"
出典: https://nodejs.org/api/process.html (取得日 2026-11-05)
Go の公式ドキュメント「os」は、標準出力を次のように説明しています。
"Stdin, Stdout, and Stderr are open Files pointing to the standard input, standard output, and standard error file descriptors."
出典: https://pkg.go.dev/os (取得日 2026-11-05)
ここに引いた Node と Go の文は、書き込みが同期か非同期か、何を指すファイルか、を述べているだけです。print の遅れにあたる行単位・ブロック単位の書き出しについては、引いた箇所には書かれていません。
比べた表:端末とパイプで、1行目はいつ届いたか
読み手のプログラムで、届いた時刻と中身を記録しました。出力はそのまま載せます。+ は、1回の読み取りに2行が入っていたことを表します。
python tty: [(0.2, 'first'), (1.7, 'second')] rc=0
python pipe: [(1.7, 'first+second')] rc=0
python pipe -u: [(0.2, 'first'), (1.7, 'second')] rc=0
python pipe PYTHONUNBUFFERED=1: [(0.1, 'first'), (1.6, 'second')] rc=0
node tty: [(0.1, 'first'), (1.6, 'second')] rc=0
node pipe: [(0.0, 'first'), (1.6, 'second')] rc=0
go tty: [(0.1, 'first'), (1.6, 'second')] rc=0
go pipe: [(0.0, 'first'), (1.5, 'second')] rc=0
表にまとめると次のとおりです。
| 言語・つなぎ方 | 1行目が届いた秒 | 2行目が届いた秒 | 1行目と2行目は別々に届いたか |
|---|---|---|---|
| Python・端末 | 0.2 | 1.7 | 別々 |
| Python・パイプ | 1.7(2行目と一緒) | 1.7 | 一緒 |
Python・パイプ+-u |
0.2 | 1.7 | 別々 |
Python・パイプ+PYTHONUNBUFFERED=1 |
0.1 | 1.6 | 別々 |
| Node・端末 | 0.1 | 1.6 | 別々 |
| Node・パイプ | 0.0 | 1.6 | 別々 |
| Go・端末 | 0.1 | 1.6 | 別々 |
| Go・パイプ | 0.0 | 1.5 | 別々 |
1行目と2行目が一緒に届いたのは、Python をパイプにつないだときだけでした。これは公式の「対話的でなければブロックバッファ」という記述と合います。-u か PYTHONUNBUFFERED=1 を付けると、パイプでも端末と同じように1行目がすぐ届きました。
パイプにつないだときの Python の状態も見ました。
$ python3 -c "import sys,io; print(sys.stdout.line_buffering, sys.stdout.isatty(), io.DEFAULT_BUFFER_SIZE, file=sys.stderr)" | cat
False False 8192
パイプでは sys.stdout.line_buffering が False、isatty() も False、io.DEFAULT_BUFFER_SIZE は 8192 でした。
出典: 自社の実測(2026-11-06)
どちらを使うか:-u・PYTHONUNBUFFERED・flush=True
Python の出力をパイプやログに流していて、行ごとにすぐ届いてほしいときの選択肢は3つです。
- プロセス全体を変えたいなら
-uかPYTHONUNBUFFERED。公式に、どちらでも stdout と stderr をバッファなしにできると書かれています。-uはコマンドラインの引数として、PYTHONUNBUFFEREDは環境変数として渡します。実測でも、どちらを付けてもパイプで1行目がすぐ届きました。 - 特定の行だけ確実に出したいなら
print(..., flush=True)。flush引数の既定は False です。後で見るとおり、flush=Trueを付けた行はos._exit(0)で即時終了しても残りました。
Node と Go は、今回の書き方(console.log と、os.Stdout に直接書く fmt.Println)では、端末でもパイプでも1行目がすぐ届きました。同じ書き方では、この差は出ませんでした。
出典: 自社の実測(2026-11-06)
落とし穴:強制終了すると、溜まった行は消える
遅れて届くだけならまだいいのですが、プロセスが正常に終わらないと、溜まっていた行はそのまま消えます。
パイプ越しに文字を受け取る話としては、Pythonのsubprocess、バイナリとテキストはどう違う?や、Python 3.15のopen()既定はUTF-8かロケールかの記事もあります。
print の後に os._exit(0) で即時終了するスクリプト(e2.py)をパイプにつなぐと、何も出ませんでした。
import os
print('lost?')
os._exit(0)
$ python3 e2.py | cat
(出力なし)
1行目だけ flush=True にすると(e3.py)、その行だけ残りました。
print('flushed',flush=True)
import os;print('lost?')
os._exit(0)
$ python3 e3.py | cat
flushed
ファイルにリダイレクトした場合も同じで、0バイトでした。
$ python3 e2.py > e2.out; wc -c < e2.out
0
print の後に30秒眠るスクリプト(e4.py)を、1秒後に kill -9 で止めたときも0バイトでした。
$ (python3 e4.py > e4.out & P=$!; sleep 1; kill -9 $P); wc -c < e4.out # e4.py は print の後に30秒眠る
0
今回の実測で即時終了の後まで残ったのは、print(..., flush=True) した行だけでした。-u や PYTHONUNBUFFERED=1 を付けたときに、os._exit(0) や kill -9 で終わらせて行が残るかは測っていません。-u と PYTHONUNBUFFERED=1 で確かめたのは、パイプで1行目がすぐ届くかどうかだけです。
なお、次の条件も測っていません。Windows、Python 3.9 以外の版、Node の process.stdout.write で大量に書いた場合(公式には POSIX のパイプは非同期とあります)、Go で bufio.Writer を使った場合です。これらで同じ結果になるかは確認できていません。
出典: 自社の実測(2026-11-06)
自分の環境で確かめる手順
パイプにつないで、1行目が2行目と一緒に出るかを見ます。続けて -u 付き、PYTHONUNBUFFERED=1 付きでも試し、最後に即時終了で行が残るかを flush=True の有無で比べます。
python3 -c "import time; print('first'); time.sleep(1.5); print('second')" | cat
python3 -u -c "import time; print('first'); time.sleep(1.5); print('second')" | cat
PYTHONUNBUFFERED=1 python3 -c "import time; print('first'); time.sleep(1.5); print('second')" | cat
python3 -c "import os; print('lost?'); os._exit(0)" | cat
python3 -c "import os; print('flushed', flush=True); print('lost?'); os._exit(0)" | cat
python3 -c "import sys,io; print(sys.stdout.line_buffering, sys.stdout.isatty(), io.DEFAULT_BUFFER_SIZE, file=sys.stderr)" | cat
1行目では、first が出るまでに待ち時間があるかを見てください。2行目と3行目では、それが変わるかを比べます。4行目と5行目は、即時終了で行が残るかの確認です。flush=True を付けた5行目で flushed だけが出るかを見ます。6行目は、パイプにつないだときのバッファの状態を表示します。

コメント