Python の print バッファリングはパイプで遅れる?Node・Go比較

要点

  • 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行目は、パイプにつないだときのバッファの状態を表示します。

コメント

タイトルとURLをコピーしました