os.path.exists / isfile / isdir)os.mkdir / os.makedirs)とパーミッション(アクセス権限)の指定shutil.copyfile / copy / copy2 / copytree)os.remove / os.rmdir / shutil.rmtree)print 文や8進数表記が動かないことがある(対策は「エラー」ページ参照)。pip install は不要。python3 -m venv venv → source venv/bin/activate(Windows は venv/Scripts/activate)。import os
os.path.exists("./example/example.txt")
True #存在する
False #存在しない
os.path.exists("./example")
True #存在する
False #存在しない
os.path.isfile("./example/example.txt")
True #ファイルである
os.path.isfile("./example")
False #ファイルでない
os.path.isfile("./example/example.csv")
False #ファイルがない
os.path.isdir("./example")
True #ディレクトリである
os.path.isfile("./example/example.txt")
False #ディレクトリでない
os.path.isfile("./example")
False #ディレクトリがない
カレントディレクトリからの相対ディレクトリ、もしくは絶対ディレクトリで指定
os.mkdir('example_dir')
os.mkdir('./example_dir')
os.mkdir('/home/user/example_dir')
親ディレクトリもまとめて生成したい場合
os.makedirs('/parent_dir/child_dir')
755 は所有者=7(全部)、グループ=5(読み+実行)、その他=5。os.chmod(path, 0o755) のように頭に 0o を付けると8進数になる。Python 2 の 0777 書き方は Python 3 では SyntaxError: invalid token になる(具体的なエラーと直し方は「エラー」ページ参照)。stat モジュールの定数で書くと意図が読みやすい: os.chmod(path, stat.S_IRWXU | stat.S_IRWXG) のように組み合わせる。0o644(所有者は読み書き、他は読みのみ)、0o755(所有者は全部、他は読み+実行)、0o600(所有者のみ読み書き)。所有権
| 意味 | |
|---|---|
| 自分(Owner) | ファイル/ディレクトリの所有者、本人のこと |
| グループ(Group) | 同じサーバーを利用できるユーザ全体 |
| 他人(Other) | その他全て、第三者のこと |
実行権
| ファイル | ディレクトリ | |
|---|---|---|
| 読み | 指定したファイルの内容を表示する | リストの表示可能 |
| 書き | ファイルの上書き、削除 | ディレクトリに新規ファイル作成可能 |
| 実行 | 実行ファイルの実行(プログラム、CGIなど) | カレントディレクトリにすることができる |
読み」「書き」「実行」の3つの実行権は以下の記号または数字で表される。
| 記号 | 数字 | |
|---|---|---|
| 読むことができる (Readable) | r | 4 |
| 書くことができる (Writable) | w | 2 |
| 実行することができる (eXecutable) | x | 1 |
| なにもできない | - | 0 |
os.chmod( path, mode,…)
shutil.copyfile(src, dst):中身だけをコピー。コピー先はファイル名で指定する。shutil.copy(src, dst):コピー先にディレクトリ名も指定できる。ファイルのモード(パーミッション)までコピーする点が copyfile と異なる。shutil.copy2(src, dst):タイムスタンプなどのメタデータまで保持する。バックアップ用途ならこれを使う。SameFileError になる。shutil.copytree はコピー先が既に存在すると OSError: [Errno 17] File exists で失敗する。既存ディレクトリに中身を足したい場合は distutils.dir_util.copy_tree を使う(このページのサンプルもその構成)。| cmd | 挙動 |
|---|---|
| copyfile | メタデータはコピーされず、ファイル作成日は新規 |
| copy | メタデータはコピーされず、ファイル作成日は新規 |
| copy2 | メタデータがコピーされ、ファイル作成日も保持 |
使用するライブラリ
import shutil
使用例
shutil.copyfile("./example.txt", "./example2.txt")
shutil.copy("./example.txt", "./example2.txt")
shutil.copy2("./example.txt", "./example2.txt")
新たにディレクトリを作成してコピー
shutil.copytree("./example", "./example2")
この時に、コピー先のディレクトリがあるとエラーが出る。
os.mkdir(""./example2")
shutil.copytree("./example", "./example2")
OSError: [Errno 17] File exists: './example2'
そういう場合はインポート
from distutils.dir_util import copy_tree
copy_tree("./example", "./example2")
os.remove("./example2.txt")
os.rmdir("./example")
os.rmdir は中身のあるディレクトリで OSError: [Errno 66] Directory not empty になる。中身ごと消すなら shutil.rmtree を使う。shutil.rmtree は取り消しできない。消す前に shutil.copytree で退避するか、パスを再確認してから実行する。/ やホーム直下を指定しないよう print で確認してから実行すると安全。shutil.rmtree("./example")
Q. os.path.exists と os.path.isfile は何が違うか
A. exists はファイル・ディレクトリ・シンボリックリンクのどれかに一致すれば真を返す。isfile は「ファイルであること」まで確認する。ディレクトリも真になる exists では区別できない場合に使い分ける。
Q. 存在しないパスを os.remove するとどうなるか
A. FileNotFoundError が出る。事前に os.path.exists で確認するか、if os.path.exists(p): os.remove(p) のように条件付きで削除すると安全。
Q. Windows と Linux でパスの書き方はどう違うか
A. Windows は C:\Users\... のようにバックスラッシュを使うが、Python 文字列内では r'...' の raw 文字列にするか C:/Users/... とスラッシュで書く。os.path.join を使えば OS ごとの区切り文字を自動で補ってくれる。
🤖 このページにはAIエージェント(ノア)による編集・加筆が含まれます。内容の正確性は保証できないため、重要な判断は一次情報でご確認ください。