Python Path.write_bytes()の使い方|バイナリをファイルに書き込む・追記できない理由とBytesIOの保存
Path.write_bytes(data)は、bytes型のデータをファイルに1行で書き込むpathlibのメソッドで、戻り値は書き込んだバイト数です。同じ名前のファイルがあれば上書きされ、追記はできないので、追記したいときは Path.open(“ab”) を使います。
この記事では、write_bytes()の書き方と、実際に困りやすい点(strを渡したときのエラー、フォルダが無いときのエラー、BytesIOの中身の保存、ダウンロードしたファイルの保存、大きなファイル)を、Python 3.12で実行した結果つきで説明します。pathlibでのファイル操作全体(作成・読み込み・削除)はpathlibでファイルを作成・読み書き・削除する方法にまとめているので、ここでは「バイナリを書き込む」ことに絞ります。
write_bytes()の基本の書き方
from pathlib import Path
p = Path("out.bin")
n = p.write_bytes(b"\x89PNG\r\n\x1a\n")
print(n)
print(p.read_bytes())
実行結果:
8
b'\x89PNG\r\n\x1a\n'
公式ドキュメントでは、write_bytes()は「ファイルをバイナリモードで開き、データを書き込み、閉じる」メソッドで、同じ名前のファイルがあれば上書きすると説明されています(pathlib公式ドキュメント、2026年10月18日確認)。open()とwithを書く必要がないので、データが手元にそろっているときはこれがいちばん短い書き方です。
open(“wb”)との対応
write_bytes()は、次の3行とほぼ同じことをしています。
with open("out.bin", "wb") as f:
f.write(b"\x89PNG\r\n\x1a\n")
| やりたいこと | 書き方 |
|---|---|
| bytesを丸ごと書く(上書き) | Path(...).write_bytes(data) |
| bytesを末尾に足す(追記) | with Path(...).open("ab") as f: f.write(data) |
| 少しずつ書く(大きなファイル) | with Path(...).open("wb") as f:の中で何回もf.write() |
| 文字列を書く | Path(...).write_text(text, encoding="utf-8") |
戻り値はバイト数(write_text()は文字数)
from pathlib import Path
print(Path("a.txt").write_text("こんにちは", encoding="utf-8"))
print(Path("b.bin").write_bytes("こんにちは".encode("utf-8")))
実行結果:
5
15
同じ「こんにちは」でも、write_text()は文字数の5、write_bytes()はUTF-8で15バイトと返します。保存できたサイズを確かめたいときはwrite_bytes()の戻り値がそのままファイルサイズになります。
よくあるエラー
strを渡すと TypeError
from pathlib import Path
Path("out.bin").write_bytes("こんにちは")
実行結果(最後の行):
TypeError: memoryview: a bytes-like object is required, not 'str'
write_bytes()が受け取るのはbytes(またはbytearrayなどのbytes-likeなオブジェクト)だけです。文字列ならwrite_text()を使うか、"こんにちは".encode("utf-8")でbytesにしてから渡します。
保存先のフォルダが無いと FileNotFoundError
from pathlib import Path
Path("images/2026/logo.png").write_bytes(b"\x89PNG")
実行結果(最後の行):
FileNotFoundError: [Errno 2] No such file or directory: 'images/2026/logo.png'
ファイルは新しく作られますが、途中のフォルダは自動では作られません。先にmkdir()でフォルダを作ります。
from pathlib import Path
out = Path("images/2026/logo.png")
out.parent.mkdir(parents=True, exist_ok=True)
print(out.write_bytes(b"\x89PNG"))
実行結果:
4
mkdir()の引数の意味はPath.mkdir()の記事で説明しています。
上書きされる・追記はできない
from pathlib import Path
p = Path("data.bin")
p.write_bytes(b"AAAA")
p.write_bytes(b"BB")
print(p.read_bytes())
with p.open("ab") as f:
f.write(b"CC")
print(p.read_bytes())
実行結果:
b'BB'
b'BBCC'
2回目のwrite_bytes()で前のAAAAは消えました。write_bytes()には追記の引数が無いので、追記したいときはopen("ab")(aが追記、bがバイナリ)で開いてwrite()します。
BytesIOの中身をファイルに保存する
画像の加工やZIPの作成などで、データをいったんメモリ上のio.BytesIOに書き出すことがあります。それをファイルにするときはgetvalue()でbytesを取り出して渡します。
import io
from pathlib import Path
buf = io.BytesIO()
buf.write(b"first,")
buf.write(b"second")
Path("from_bytesio.bin").write_bytes(buf.getvalue())
print(Path("from_bytesio.bin").read_bytes())
実行結果:
b'first,second'
buf.read()を使う場合は、書き込んだあと読み取り位置が末尾にあるため、先にbuf.seek(0)が必要です。getvalue()なら位置に関係なく全体が取れます。
ダウンロードしたファイルを保存する
いちばんよく使う場面です。python.orgのロゴ画像を標準ライブラリだけで保存してみます。
import urllib.request
from pathlib import Path
url = "https://www.python.org/static/img/python-logo.png"
with urllib.request.urlopen(url, timeout=30) as res:
data = res.read()
n = Path("python-logo.png").write_bytes(data)
print(n, "バイト")
print(Path("python-logo.png").read_bytes()[:8])
実行結果(2026年10月18日に実行):
15770 バイト
b'\x89PNG\r\n\x1a\n'
先頭の8バイトがPNG画像の目印になっているので、正しく保存できたことが分かります。requestsを使う場合は、Path("logo.png").write_bytes(res.content)のようにres.content(bytes)を渡します。res.textは文字列に変換されたものなので、画像やPDFには使えません。requestsの使い方はrequestsの記事をご覧ください。
大きなファイルは少しずつ書く・途中で失敗に備える
write_bytes()は、書き込むデータ全体を一度にメモリに持っている必要があります。動画やZIPのような大きなファイルは、受け取りながら少しずつ書き出すほうが安全です。さらに、通信が途中で切れたときに壊れたファイルが残らないよう、一時ファイルに書いてから名前を変えます。
import urllib.request
from pathlib import Path
url = "https://www.python.org/static/img/python-logo.png"
target = Path("python-logo.png")
tmp = target.with_name(target.name + ".part")
with urllib.request.urlopen(url, timeout=30) as res, tmp.open("wb") as f:
while chunk := res.read(1024 * 1024): # 1MBずつ
f.write(chunk)
tmp.replace(target)
print(target.stat().st_size, "バイト", tmp.exists())
実行結果:
15770 バイト False
最後まで受け取れたときだけreplace()で本来の名前に変わるので、途中で失敗しても.partのファイルが残るだけで、前に保存していたファイルは壊れません。replace()の動きはos.replace()の記事で説明しています。
改行コードを変えずに書きたいとき
write_text()(テキストモード)は、Windowsでは\nを\r\nに変えて書き込みます(open()の公式ドキュメントのnewline引数の説明、2026年10月18日確認)。write_bytes()はデータを一切変えずに書くので、改行コードを含めて中身をそのまま保ちたいファイルに向いています。
from pathlib import Path
p = Path("crlf.txt")
p.write_bytes(b"line1\r\nline2\r\n")
print(p.read_bytes())
print(repr(p.read_text(encoding="utf-8")))
実行結果:
b'line1\r\nline2\r\n'
'line1\nline2\n'
ファイルには\r\nのまま入っています。read_text()で読むと\nに変換されて見える点に注意してください。中身を確かめるときはread_bytes()で読みます。
よくある質問
Q. write_bytes()で追記できますか?
できません。write_bytes()は毎回ファイルを上書きします。追記したいときは Path.open(“ab”) でファイルを開き、write() で書き足します。
Q. write_bytes()の戻り値は何ですか?
書き込んだバイト数です。write_text() が返すのは文字数なので、日本語を含む場合は値が変わります。たとえば「こんにちは」は5文字ですが、UTF-8では15バイトです。
Q. BytesIOをファイルに保存するには?
buf.getvalue() で中身をbytesとして取り出し、Path(“保存先”).write_bytes(buf.getvalue()) のように渡します。buf.read() を使う場合は、先に buf.seek(0) で読み取り位置を先頭に戻します。
Q. 「a bytes-like object is required, not ‘str’」と出ます
write_bytes() に文字列を渡しています。文字列を書くなら write_text() を使うか、encode(“utf-8”) でbytesに変換してから渡してください。





