Python入門トップページ


目次

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

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

OSの違いを吸収するディレクトリ指定方法

プログラム本体の保存場所と同じ階層に「data」という名前のディレクトリ(フォルダ)を作成し,「score.txt」を準備します.ここで注意すべきことは Window 環境ではディレクトリの区切りに「\(バックスラッシュ,日本語環境では円マーク)」,Mac や Linux では「/(スラッシュ)」が使われているということです.ディレクトリとファイル名を指定してファイルを開くときに,OSによってディレクトリの区切り文字が異なるので,その違いを吸収できる書き方を考えよう.

データファイル (data/score.txt)
74 62 98

まず,Windows の区切り文字「\」はエスケープが必要であるので「\\」のように書く必要があります.

ファイルを開く (prog11-1.py)
f = open('data\\score.txt', 'r', encoding='utf-8')
msg = f.readline()
f.close()
print(msg)

エスケープを利用しない場合はエラー(又は警告)が表示されることになるでしょう.

ファイルを開く (prog11-2.py)
f = open('data\score.txt', 'r', encoding='utf-8')
msg = f.readline()
f.close()
print(msg)

一方で,Mac や Linux は「/」で区切ります.

ファイルを開く (prog11-3.py)
f = open('data/score.txt', 'r', encoding='utf-8')
msg = f.readline()
f.close()
print(msg)

Windowsで実行してみる

Windows (PowerShell) で上の3つのプログラムを順番に実行します.エスケープした(「\\」)プログラムは期待通り動作しました.

PowerShell 5/7
(base) PS C:\Users\rinsaka\Documents\python> python prog11-1.py ⏎
74 62 98

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

エスケープしていないプログラムでは警告が表示されましたが,動作もしました.

PowerShell 5/7
(base) PS C:\Users\rinsaka\Documents\python> python prog11-2.py ⏎
C:\Users\rinsaka\Documents\python\prog11-2.py:1: SyntaxWarning: invalid escape sequence '\d'
  f = open('data\score.txt', 'r', encoding='utf-8')
74 62 98

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

Windows では Mac の区切り文字を利用しても動作しました.

PowerShell 5/7
(base) PS C:\Users\rinsaka\Documents\python> python prog11-3.py ⏎
74 62 98

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

目次に戻る

Mac (Linux) で実行してみる

Mac や Linux ではディレクトリの区切り文字に「/」が用いられるので,Windows で動作した「\\」や「\」ではエラーになります.

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog11-1.py ⏎
Traceback (most recent call last):
  File "/Users/rinsaka/Documents/python/prog11-1.py", line 1, in <module>
    f = open('data\\score.txt', 'r', encoding='utf-8')
FileNotFoundError: [Errno 2] No such file or directory: 'data\\score.txt'
(base) rinsaka@MacBookPro2026 python %

「\」では警告とエラーが表示されました.

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog11-2.py ⏎
/Users/rinsaka/Documents/python/prog11-2.py:1: SyntaxWarning: "\d" is an invalid escape sequence. Such sequences will not work in the future. Did you mean "\\d"? A raw string is also an option.
  f = open('data\score.txt', 'r', encoding='utf-8')
Traceback (most recent call last):
<unknown>:2: SyntaxWarning: "\d" is an invalid escape sequence. Such sequences will not work in the future. Did you mean "\\d"? A raw string is also an option.
<unknown>:1: SyntaxWarning: "\d" is an invalid escape sequence. Such sequences will not work in the future. Did you mean "\\d"? A raw string is also an option.
  File "/Users/rinsaka/Documents/python/prog11-2.py", line 1, in <module>
    f = open('data\score.txt', 'r', encoding='utf-8')
FileNotFoundError: [Errno 2] No such file or directory: 'data\\score.txt'
(base) rinsaka@MacBookPro2026 python %

「/」ではもちろん期待通り動作します.

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog11-3.py ⏎
74 62 98

(base) rinsaka@MacBookPro2026 python %

目次に戻る

OS モジュールを使う

Python の標準モジュール os モジュールを使うと OS の違いを吸収できるようになります.まずプログラムの先頭でモジュールを読み込んでおきます.

モジュールを読み込む
import os

現在のディレクトリ(フォルダ)を取得してみよう.これには os.getcwd (GET Current Working Directory) を利用すると良いでしょう.

現在のディレクトリを取得 (prog12-1.py)
import os

cwd = os.getcwd()
print(cwd)

PowerShell 5/7
(base) PS C:\Users\rinsaka\Documents\python> python prog12-1.py ⏎
C:\Users\rinsaka\Documents\python
(base) PS C:\Users\rinsaka\Documents\python>

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog12-1.py ⏎
/Users/rinsaka/Documents/python
(base) rinsaka@MacBookPro2026 python %

次は OS で使われるディレクトリの区切り文字を取得します.

ディレクトリの区切り文字を取得する (prog12-2.py) 
import os
print(os.path.sep)

PowerShell 5/7
(base) PS C:\Users\rinsaka\Documents\python> python prog12-2.py ⏎
\
(base) PS C:\Users\rinsaka\Documents\python>

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog12-2.py ⏎
/
(base) rinsaka@MacBookPro2026 python %

文字列の join メソッドを使うと,引数に与えた文字列のリストを指定した文字列を区切り文字として連結できます.したがって,「現在のディレクトリ」「サブディレクトリ名」「ファイル名」からなるリストを引数に渡すことで,OS の違いを吸収したファイルのパスを生成できます.したがって,同じコードが Windows でも Mac でも動くようになります.

ファイルパスを生成 (prog12-3.py)
import os
cwd = os.getcwd()
file_path = os.path.sep.join([cwd, 'data', 'score.txt'])
print(file_path)

PowerShell 5/7
(base) PS C:\Users\rinsaka\Documents\python> python prog12-3.py ⏎
C:\Users\rinsaka\Documents\python\data\score.txt
(base) PS C:\Users\rinsaka\Documents\python>

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog12-3.py ⏎
/Users/rinsaka/Documents/python/data/score.txt
(base) rinsaka@MacBookPro2026 python %

目次に戻る

OS の違いを吸収できるファイルの開き方

上の方法を使って,「data」ディレクトリに保存された「score.txt」を絶対パス指定で開いてみよう.この方法を使えば,Windows でも Mac でも正しくファイルを開くことができます.

絶対パス指定でファイルを開く (prog13.py)
import os # モジュールのインポート
cwd = os.getcwd() # 現在のディレクトリ
dir = 'data' # ファイルが保存されたディレクトリ名
file = 'score.txt' # 開きたいファイル名
file_path = os.path.sep.join([cwd, dir, file]) # ファイルまでの絶対パスを生成
f = open(file_path, encoding='utf-8') # ファイルを開く
msg = f.readline() # ファイルを読み込む
f.close() # ファイルを閉じる
print(msg) # ファイルの内容を画面に表示
74 62 98

相対パス指定で開くこともできるはずです.この場合は現在のディレクトリを取得する必要はありません.

相対パス指定でファイルを開く (prog14.py)
import os # モジュールのインポート
dir = 'data' # ファイルが保存されたディレクトリ名
file = 'score.txt' # 開きたいファイル名
file_path = os.path.sep.join([dir, file]) # ファイルまでの相対パスを生成
f = open(file_path, encoding='utf-8') # ファイルを開く
msg = f.readline() # ファイルを読み込む
f.close() # ファイルを閉じる
print(msg) # ファイルの内容を画面に表示
74 62 98

なお,os.path.sep.join() を使ったディレクトリ指定は,必ずしも直感的ではありません.次の pathlib モジュールを利用すると,より直感的にパスを指定できるようになります.

目次に戻る

pathlib モジュールを利用する

pathlib モジュールはファイルシステムのパスを表すクラスを提供し,同じコードでも Windows や macOS など様々な OS 応じて適切な Path オブジェクトを生成します.

まず,プログラムと同じ場所(ディレクトリ)に data ディレクトリがある場合を考えます.この場合,Path(__file__).parent で現在のディレクトリを取得できます.その後,区切り文字 / を使って直感的に記述することができます.これは pathlib.Path では「/」が演算子オーバーロード (operator overloading) という仕組みを使って,「除算」から「(文字列のように連結し,OSに応じて適切な)パスの生成」に再定義されているからです.

プログラムと同じ場所に data ディレクトリがある場合 (prog21.py)
from pathlib import Path

BASE_DIR = Path(__file__).parent
data_file = BASE_DIR / "data" / "score.txt"

print(data_file)
print(type(data_file))

PowerShell 5/7
(base) PS C:\Users\rinsaka\Documents\python> python prog21.py ⏎
C:\Users\rinsaka\Documents\python\data\score.txt
<class 'pathlib._local.WindowsPath'>
(base) PS C:\Users\rinsaka\Documents\python>

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog21.py ⏎
/Users/rinsaka/Documents/python/data/score.txt
<class 'pathlib.PosixPath'>
(base) rinsaka@MacBookPro2026 python %

ホームディレクトリを基準にディレクトリを指定することもできます.たとえば,ユーザごとの Documents ディレクトリにある python ディレクトリ内にさらに data ディレクトリが存在する場合は次のように書くことができます.

ホームディレクトリ基準の場合 (prog22.py)
from pathlib import Path

data_file = Path.home() / "Documents" / "python" / "data" / "score.txt"

print(data_file)
print(type(data_file))

PowerShell 5/7
(base) PS C:\Users\rinsaka\Documents\python> python prog22.py ⏎
C:\Users\rinsaka\Documents\python\data\score.txt
<class 'pathlib._local.WindowsPath'>
(base) PS C:\Users\rinsaka\Documents\python>

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog22.py ⏎
/Users/rinsaka/Documents/python/data/score.txt
<class 'pathlib.PosixPath'>
(base) rinsaka@MacBookPro2026 python %

なお,pathlib ではフルパスだけでなく,ファイル名(filename),基底名 (basename),拡張子 (extention) などを取り出すことができます.なお,basename は stem,extention は suffix を利用することに注意してください.詳細はここを参照すると良く理解できることでしょう.

パスの各要素を取り出す (prog23.py)

from pathlib import Path

BASE_DIR = Path(__file__).parent
data_file = BASE_DIR / "data" / "score.txt"

print(data_file)
print(f"parent: {data_file.parent}")
print(f"name  : {data_file.name}")
print(f"stem  : {data_file.stem}")
print(f"suffix: {data_file.suffix}")

PowerShell 5/7
(base) PS C:\Users\rinsaka\Documents\python> python prog23.py ⏎
C:\Users\rinsaka\Documents\python\data\score.txt
parent: C:\Users\rinsaka\Documents\python\data
name  : score.txt
stem  : score
suffix: .txt
(base) PS C:\Users\rinsaka\Documents\python>

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog23.py ⏎
/Users/rinsaka/Documents/python/data/score.txt
parent: /Users/rinsaka/Documents/python/data
name  : score.txt
stem  : score
suffix: .txt
(base) rinsaka@MacBookPro2026 python %

いずれにせよ,pathlib モジュールを利用すると,直感的にパスを記述でき,様々な OS で動作するコードを書くことができます.次のとおり,データファイルを開いて表示してみます.

データファイルを開いてみる (prog24.py)
from pathlib import Path

BASE_DIR = Path(__file__).parent
data_file = BASE_DIR / "data" / "score.txt"

f = open(data_file, encoding='utf-8') # ファイルを開く
msg = f.readline() # ファイルを読み込む
f.close() # ファイルを閉じる
print(msg) # ファイルの内容を画面に表示
print(data_file)

PowerShell 5/7
(base) PS C:\Users\rinsaka\Documents\python> python prog24.py ⏎
74 62 98

C:\Users\rinsaka\Documents\python\data\score.txt
(base) PS C:\Users\rinsaka\Documents\python>

Mac (bash)
(base) rinsaka@MacBookPro2026 python % python prog24.py ⏎
74 62 98

/Users/rinsaka/Documents/python/data/score.txt
(base) rinsaka@MacBookPro2026 python %

目次に戻る