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に変換してから渡してください。

あわせて読みたい

対面・無料|東京・永田町で毎週土曜日13時

1回の参加で、プログラミングの構造がわかる

ゼロからはじめるPython入門講座

8年間・累計600回開催/これまで全国で2万人以上が参加

「やはり対面で聞けるのはとても気づきがあり、価値があると思います」

参加者の声

  • 本当に初心者からの講座です。プログラミングに触ったことがなくて大丈夫です
  • 対面だから、その場で聞けます。つまずいた所を持ち帰らずに解決できます
  • 講座は1時間。そのあとも残って学習を続けられ、講師にも質問できます
  • 独学で挫折した方も。糸口が見つかって、講座のあと会員になる方が多くいます

無料で参加する|開催日程を見る

参加費は無料です