Python入門トップページ


目次

  1. コマンドラインでの実行時に書き出す
  2. プログラム内でのファイルの入出力
    1. ファイルに出力する
    2. ファイルに追記する
    3. ファイルを読み込む
    4. ファイルを読み込んで文字列として変数に格納する
    5. ファイルから数値を読み込む
    6. ファイルから数値を読み込みリストに格納する
  3. OSの違いを吸収するディレクトリ指定方法
  4. JSONファイルの読み込みと書き出し

ファイルの読み書きをしてみよう

プログラム内でのファイルの入出力

ここでは変数に格納された値や文字列を標準的な方法でファイルに出力したり,ファイルを開いて変数に格納する方法を説明します.

ファイルに出力する

最も標準的なファイルの出力方法は次のとおりです.

  1. open('出力ファイル名', 'w', encoding='utf-8')でファイルを開く
  2. write()で書き出す
  3. close()でファイルを閉じる
ファイルに書き出す (prog02.py)
a = 10
b = 3.14
msg = 'Hello world!'

# ファイルに書き出すための文字列を準備
s = f'{a}\n{b}\n{msg}\n'

# 書き込みモード (w) でファイルを開く
f = open('output_02.txt', 'w')

# ファイルに書き出す
f.write(s)

# ファイルを閉じる
f.close()

上のコードを実行すると,プログラムソースコードと同じフォルダ(ディレクトリ)にファイルが出力されます.出力されたファイルをそれぞれのコマンドで確認してみます.

コマンドプロンプト
(base) C:\Users\rinsaka\Documents\python>python prog02.py ⏎

(base) C:\Users\rinsaka\Documents\python>type output_02.txt ⏎
10
3.14
Hello world!

(base) C:\Users\rinsaka\Documents\python>

PowerShell
(base) PS C:\Users\rinsaka\Documents\python> python prog02.py ⏎
(base) PS C:\Users\rinsaka\Documents\python> gc output_02.txt ⏎
10
3.14
Hello world!
(base) PS C:\Users\rinsaka\Documents\python>

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog02.py ⏎
(base) rinsaka@MacBookPro2026 python % cat output_02.txt ⏎
10
3.14
Hello world!
(base) rinsaka@MacBookPro2026 python %

なお,open('出力ファイル名', 'w') でファイルを開いたとき,すでに同じ名前のファイルが存在した場合にはそのファイルの内容が消去されることに注意してください.

また,Windows 環境で日本語文字を含む文字列を書き出すと,Shift-JIS コードで保存されることになります.コマンドプロンプトや PowerShell のバージョン5系は Shift-JIS 環境が標準です.一方で PowerShell のバージョン7系や Mac では UTF-8 が標準になっています.

ファイルに書き出す (prog03.py)
a = 10
b = 3.14
msg = '日本語文字列 あいうえお'

# ファイルに書き出すための文字列を準備
s = f'{a}\n{b}\n{msg}\n'

# 文字コードを指定する
f = open('output_03.txt', 'w')

# ファイルに書き出す
f.write(s)

# ファイルを閉じる
f.close()

文字コードの指定をしないプログラムをそれぞれの環境で実行してみます.Windows では Shift-JIS で保存されるため,Shift-JIS が標準のコマンドプロンプトでは正しく表示できます.

コマンドプロンプト
(base) C:\Users\rinsaka\Documents\python>python prog03.py ⏎

(base) C:\Users\rinsaka\Documents\python>type output_03.txt ⏎
10
3.14
日本語文字列 あいうえお

(base) C:\Users\rinsaka\Documents\python>

Windows の PowerShell 5 系も同様に,正しく表示できます.

PowerShell 5
(base) PS C:\Users\rinsaka\Documents\python> python prog03.py ⏎
(base) PS C:\Users\rinsaka\Documents\python> gc output_03.txt ⏎
10
3.14
日本語文字列 あいうえお
(base) PS C:\Users\rinsaka\Documents\python>

Windows の PowerShell 7 系は UTF-8 が標準の文字コードです.したがって,Shift-JIS のファイルをそのまま表示しようとすると文字化けが発生してしまいます.

PowerShell 7
(base) PS C:\Users\rinsaka\Documents\python> $PSVersionTable.PSVersion ⏎

Major  Minor  Patch  PreReleaseLabel BuildLabel
-----  -----  -----  --------------- ----------
7      6      9

(base) PS C:\Users\rinsaka\Documents\python> python prog03.py ⏎
(base) PS C:\Users\rinsaka\Documents\python> gc output_03.txt ⏎
10
3.14
���{�ꕶ���� ����������
(base) PS C:\Users\rinsaka\Documents\python>

PowerShell 7 では次のとおり文字コードを指定することで文字化けを回避できます.

PowerShell 7
(base) PS C:\Users\rinsaka\Documents\python> gc output_03.txt -Encoding Shift-JIS ⏎
10
3.14
日本語文字列 あいうえお
(base) PS C:\Users\rinsaka\Documents\python>

Mac では標準の文字コードが UTF-8 であることから文字化けは発生しません.

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog03.py ⏎
(base) rinsaka@MacBookPro2026 python % cat output_03.txt ⏎
10
3.14
日本語文字列 あいうえお
(base) rinsaka@MacBookPro2026 python %

現在はすでに文字コードには UTF-8 を利用することが標準になっているので,次のように encoding='utf-8' または encoding='utf_8' を指定するよう心がけておくと良いでしょう.なお macOS の場合は標準で UTF-8 が使用されますが,Windows でも同じコードを実行する可能性があることを考慮すると,やはり次のとおり毎回オプションを付けるようにしておくと良いでしょう.

文字コードを指定してファイルに書き出す (prog03-utf.py)
a = 10
b = 3.14
msg = '日本語文字列 あいうえお'

# ファイルに書き出すための文字列を準備
s = f'{a}\n{b}\n{msg}\n'

# 文字コードを指定する
f = open('output_03-utf.txt', 'w', encoding='utf-8')

# ファイルに書き出す
f.write(s)

# ファイルを閉じる
f.close()

コマンドプロンプトは標準で Shift-JIS であることから,UTF-8のファイルを表示すると文字化けしてしまいます.

コマンドプロンプト
(base) C:\Users\rinsaka\Documents\python>python prog03-utf.py ⏎

(base) C:\Users\rinsaka\Documents\python>type output_03-utf.txt ⏎
10
3.14
譌・譛ャ隱樊枚蟄怜・ 縺ゅ>縺・∴縺・

(base) C:\Users\rinsaka\Documents\python>

標準では文字コード(コードページ)が CP934 であるので,コマンドプロンプトのコードページを UTF-8 (65001) に変更します.この操作で UTF-8 の文字化けが解消します.

コマンドプロンプト
(base) C:\Users\rinsaka\Documents\python>chcp ⏎
現在のコード ページ: 932

(base) C:\Users\rinsaka\Documents\python>chcp 65001 ⏎

Active code page: 65001

(base) C:\Users\rinsaka\Documents\python>chcp ⏎
Active code page: 65001

(base) C:\Users\rinsaka\Documents\python>type output_03-utf.txt ⏎
10
3.14
日本語文字列 あいうえお

(base) C:\Users\rinsaka\Documents\python>

コマンドプロンプトで2つのファイル容量を調べます.output_03.txt は1文字2バイトの Shift-JIS で,outpu_03-utf.txt は1文字3バイトの UTF-8 になっていること(つまりファイルサイズが異なること)が分かります.

コマンドプロンプト
(base) C:\Users\rinsaka\Documents\python>dir output_03* ⏎
 Volume in drive C has no label.
 Volume Serial Number is 8CDF-6D19

 Directory of C:\Users\rinsaka\Documents\python

2026/10/31  12:15                46 output_03-utf.txt
2026/10/31  12:07                35 output_03.txt
               2 File(s)             81 bytes
               0 Dir(s)  17,173,090,304 bytes free

(base) C:\Users\rinsaka\Documents\python>

Powershell 5 でもやはり UTF-8 のファイルは文字化けします.PowerShell の Get-Content コマンドレット(別名 gc)に -Encoding UTF8 を付与するとこの文字化けを解消できます.

PowerShell 5
(base) PS C:\Users\rinsaka\Documents\python> python prog03-utf.py ⏎
(base) PS C:\Users\rinsaka\Documents\python> gc output_03-utf.txt ⏎
10
3.14
譌・譛ャ隱樊枚蟄怜・ 縺ゅ>縺・∴縺・
(base) PS C:\Users\rinsaka\Documents\python> gc output_03-utf.txt -Encoding UTF8 ⏎
10
3.14
日本語文字列 あいうえお
(base) PS C:\Users\rinsaka\Documents\python>

PowerShell 7 は標準の文字コードが UTF-8 でることから,文字化けは発生しません.さらに,-Encoding UTF8 を付与することも可能です.

PowerShell 7
(base) PS C:\Users\rinsaka\Documents\python> python prog03-utf.py ⏎
(base) PS C:\Users\rinsaka\Documents\python> gc output_03-utf.txt ⏎
10
3.14
日本語文字列 あいうえお
(base) PS C:\Users\rinsaka\Documents\python> gc output_03-utf.txt -Encoding UTF8 ⏎
10
3.14
日本語文字列 あいうえお
(base) PS C:\Users\rinsaka\Documents\python>

Mac では標準の文字コードが UTF-8 です.

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog03-utf.py ⏎
(base) rinsaka@MacBookPro2026 python % cat output_03-utf.txt ⏎
10
3.14
日本語文字列 あいうえお
(base) rinsaka@MacBookPro2026 python %

したがって,UTF-8 のオプションを付与しなくても UTF-8 で出力されている(オプションを付与した場合とファイルサイズが変わらない)ことが分かります.なお,Windows の改行コードが CR+LF であり,Mac 改行コードが LF であることから,Windows と Mac ではファイルサイズが異なっていることにも注意してください.

Mac (bash)
(base) rinsaka@MacBookPro2026 python % ls -l output_03* ⏎
-rw-r--r--@ 1 rinsaka  staff  43 10月 31 13:49 output_03-utf.txt
-rw-r--r--@ 1 rinsaka  staff  43 10月 31 13:48 output_03.txt
(base) rinsaka@MacBookPro2026 python %

なお, open() で開いたファイルは利用を終えたあとに close() で閉じることを忘れないようにしてください.次のように with を使うとこのブロックの処理が終わった段階で自動的にファイルが閉じられます.

ファイルに書き出し自動的に閉じる (prog04.py)
a = 10
b = 3.14
msg = '日本語文字列 あいうえお'

# ファイルに書き出すための文字列を準備
s = f'{a}\n{b}\n{msg}\n'

# with によってファイルを自動的に閉じる
with open('output_04.txt', 'w', encoding='utf-8') as f:
    f.write(s)

目次に戻る