🌐 OS共通の基礎教養：ディレクトリと木構造の全知識｜Linux/Mac/Winで迷わない「パス指定」の正体

⚠️ FileNotFoundErrorを卒業！「カレントディレクトリ」と「相対パス」をマスターして自由自在にファイルを操作する【Python初学者必見】

コンピュータを操作する上で避けて通れない「ファイルシステム」の基本概念を、Pythonの視点から分かりやすく解説します。

---

📂 DIRECTORY & PATH CHEAT SHEET

Pythonファイル操作・ディレクトリ構造 備忘録

🧭 パスの基本記号

.	カレントディレクトリ（現在地）
..	1つ上のディレクトリ（親）
/	ディレクトリの区切り / ルート
~	ホームディレクトリ（ユーザーフォルダ）

🌳 木構造の用語

• ルート (Root): 最上位 /
• ノード (Node): 要素（ファイル/フォルダ）
• 親 (Parent): 1つ上の階層
• 子 (Child): 1つ下の階層
• 葉 (Leaf): 末端（ファイル）

🐍 Python 必答コード (pathlib)

# 現在地の確認
Path.cwd()

# パスの結合
path = Path("A") / "B" / "C.txt"

# ファイルの存在確認
path.exists()

# ディレクトリ作成
path.mkdir(parents=True, exist_ok=True)

# ファイル一覧取得
list(Path(".").glob("*.csv"))

⚠️ 実行前チェックリスト

現在地(CWD)を確認したか？
絶対パスか相対パスか意識したか？
拡張子（.txtなど）を忘れていないか？
区切り文字は正しいか？
書き込み権限はあるか？

参照: 東京大学 Pythonプログラミング入門 (utokyo-ipp) / 4-3. ディレクトリと木構造

💡 本記事でマスターする重要用語ガイド

プログラムを動かす際、コンピュータ内の「どこにファイルがあるか」を正しく指定することは不可欠です。本セクションでは、OS共通の概念であるファイルシステムの基礎を、以下の5つのキーポイントから網羅的に解説します。

• 📂 ディレクトリ（Directory）
  ファイルを整理するための「箱」のこと。Windows等の「フォルダ」と同義。
• 📍 カレントディレクトリ（CWD）
  プログラムが「今まさに作業している場所」。記号 . で表されます。
• 🗺️ パス（Path）
  ファイルまでの「住所」。ルートからの「絶対パス」と現在地からの「相対パス」があります。

• 🌳 木構造（Tree Structure）
  根（Root）から葉（Leaf）へと広がる階層的なデータ管理モデル。
• 👨‍👦 親子関係（Parent-Child）
  上の階層（親）と下の階層（子）の関係。同じ階層は「兄弟」と呼びます。
• 🔗 参照元
  東京大学：Pythonプログラミング入門 4-3

目次

• 1. ディレクトリと階層構造とは？
• 2. カレントワーキングディレクトリ（作業場所）
• 3. パス（住所）の書き方：絶対パスと相対パス
• 4. データ構造としての「木構造（ツリー構造）」
• 5. 具体的な活用シーン
• まとめ

1. ディレクトリと階層構造とは？ 📦

OS（Windows, macOS, Linux）では、ファイルは「階層的」に管理されています。

• ディレクトリ：ファイルを整理するための「箱」のこと。Windowsなどでは「フォルダ」と呼ばれます。
• 階層構造：ディレクトリの中にさらにディレクトリを入れることで、ピラミッドのような構造になります。

参考資料： Pythonプログラミング入門（東京大学）4-3. ディレクトリと木構造

2. カレントワーキングディレクトリ（CWD）📍

プログラムが実行されている「今いる場所」をカレントワーキングディレクトリと呼びます。

• 重要性：ファイル名を指定するだけで読み込めるのは、そのファイルがカレントディレクトリにある場合のみです。
• Pythonでの操作：os.chdir() を使うと、プログラム実行中に作業ディレクトリを変更できます。
• 記号の約束：カレントディレクトリは . （ドット1つ）という特別な記号で表現されます。

3. パス（住所）の書き方 🗺️

ファイルやディレクトリの場所を示す表記を「パス（Path）」と呼びます。

種類	説明	例
絶対パス	ルート（最上位 /）から全て記述する住所	/Users/name/project/test.txt
相対パス	現在の場所を起点にした道順	./text/novel.txt

💡 覚えておきたい特殊記号

• . ：現在のディレクトリ（カレント）
• .. ：1つ上のディレクトリ（親ディレクトリ）
• / ：階層の区切り

4. データ構造としての「木構造」 🌳

ディレクトリ構造は、根から枝が広がるように見えるため「木構造（ツリー構造）」と呼ばれます。

• ノード (Node)：ファイルやディレクトリの総称。
• 根 (Root)：最上位のディレクトリ。
• 葉 (Leaf)：末端にあるファイル。
• 親子関係：上の階層が「親」、その中に含まれるのが「子」。同じ親を持つもの同士は「兄弟」と呼ばれます。

5. 具体的な活用シーン 🛠️

この知識は、実際のプログラミングで以下のように使われます。

• データ分析：大量のCSVファイルが格納された data/ フォルダから特定のファイルを読み込む。
• Web開発：static/img/ にある画像ファイルをHTMLに表示させるためにパスを指定する。
• 自動化ツール：プログラムで新しいフォルダを自動作成し（os.mkdir）、ログファイルを整理して保存する。

---

✅ まとめ：ここだけは押さえよう！

• ディレクトリ ＝ ファイルを入れる「フォルダ」。
• カレントディレクトリ ＝ プログラムが「今いる場所」。記号は . 。
• 上の階層 ＝ .. で表現する。
• パス ＝ ファイルまでの住所。スラッシュ / で繋ぐ。
• 木構造 ＝ 親子関係で成り立つデータの形。Pythonの「辞書の入れ子」とも相性が良い。

🚀 実践：Pythonでディレクトリを自由自在に操る

1. モダンなパス操作（pathlibライブラリ）

従来の os.path よりも、現在推奨されているのは pathlib です。パスを「文字列」ではなく「オブジェクト」として扱えるため、OSごとの区切り文字（/ や \）の違いを自動で解決してくれます。

from pathlib import Path # 絶対パスと相対パスの作成 absolute = Path("/usr/bin/python") relative = Path("text/novel.txt") # パスの組み立て（スラッシュ演算子が使えます！） new_path = Path("ipp_textbook") / "section4" / "test.txt" print(new_path) # ipp_textbook/section4/test.txt

2. ディレクトリ作成とファイル一覧の取得

指定したディレクトリの中に、どんなファイルがあるかをリストアップします。

p = Path('.') # カレントディレクトリ # 新しいディレクトリの作成（存在してもエラーにしない） (p / "new_folder").mkdir(exist_ok=True) # ファイル一覧の取得 for file in p.iterdir(): print(file.name) # ディレクトリ内のファイル名を順に表示

3. 応用：ファイルの一括リネームと整理

例えば、拡張子が .txt のファイルをすべて backup/ フォルダに移動し、名前に日付を付ける自動化スクリプトです。

import shutil backup_dir = Path("backup") backup_dir.mkdir(exist_ok=True) for txt_file in Path('.').glob("*.txt"): # 名前の変更：old.txt -> old_backup.txt new_name = txt_file.stem + "_backup" + txt_file.suffix # 移動 shutil.move(str(txt_file), str(backup_dir / new_name)) print(f"Moved: {txt_file} -> {backup_dir / new_name}")

💡 相対パスの指定ミスを防ぐコツ

• まずは「現在地」を確認：print(Path.cwd()) を実行し、自分がどこにいるか目視する習慣をつけましょう。
• タブ補完を使う：ターミナルやIDE（VS Codeなど）では、パスを打つ際にTabキーを押すと候補が出ます。出ない場合はパスが間違っています。

📝 ミニクイズ

現在の場所が IPP_textbook/4/ のとき、IPP_textbook/index.ipynb を指す正しい相対パスはどれ？

1. index.ipynb
2. ./index.ipynb
3. ../index.ipynb

答えを確認する

正解は 3. ../index.ipynb です。
1つ上の階層（IPP_textbook）に戻る必要があるため、.. を使います。

🚩 油断大敵！ひっかけ一問一答テスト

初心者がミスしやすいポイントを厳選しました。全問正解できれば免許皆伝です！

【Q1】パスの先頭が / から始まらない場合（例：text/data.txt）、それは何パスとして扱われる？

正解を見る

A1: 相対パス

パスが / 以外から始まる場合は、自動的に先頭に ./ が補われているとみなされ、現在の場所（カレントディレクトリ）からの経路として扱われます。

【Q2】カレントディレクトリに sample.txt があるとき、open('sample.txt') と open('./sample.txt') は動作が異なる？

正解を見る

A2: 同じ動作をする（異ならない）

ファイル名だけで指定しても、システム側で自動的に ./（カレントディレクトリ）が補われるため、結果は全く同じになります。

【Q3】os.chdir('..') を実行すると、現在の場所はどう変化する？

正解を見る

A3: 1つ上の親ディレクトリに移動する

.. は親ディレクトリを指す記号です。コマンドライン（ターミナル）の cd .. と同じ動きをします。

【Q4】木構造において、1つの「子」ノードが複数の「親」ノードを持つことはある？

正解を見る

A4: 原則として「ない」

ファイルシステムの木構造では、1つのファイルやディレクトリは必ず1つの親ディレクトリに属します。※シンボリックリンクなどの特殊な例外を除き、基本ルールとしては「親は常に1つ」です。

【Q5】パス ./text/../sample.txt は結局どの場所のファイルを指している？

正解を見る

A5: カレントディレクトリ直下の sample.txt

./text/ で1段下がり、直後の ../ で再び1段上がっているため、元のカレントディレクトリに戻っています。よって ./sample.txt と同じ場所になります。

💡 全問正解できなかった方は、もう一度「パスの書き方」を読み直してみましょう！

🎓 さらなる理解のために：周辺知識と背景知識

🚀 なぜ「木構造」を学ぶのか？

ディレクトリの管理に使われる「木構造」は、コンピュータサイエンスにおいて最も強力な武器の一つです。 例えば、ウェブサイトのHTML（DOM構造）や、家系図、会社の組織図などもすべて同じ仕組みで動いています。 「親を辿ればルートに辿り着き、子を辿ればデータに辿り着く」というこの普遍的なルールを知ることで、Pythonの高度なデータ分析やWebアプリ開発の理解が劇的にスムーズになります。

🌍 歴史的背景：OSによる「スラッシュ」の違い

豆知識として、パスの区切り文字はOSによって異なります。LinuxやmacOSは /（スラッシュ）を使いますが、Windowsでは伝統的に \（バックスラッシュ/円記号）が使われてきました。 Pythonはこの違いを賢く吸収してくれますが、プログラムを配布する際は「OSに依存しないパスの書き方」を意識することがプロへの第一歩です。

本稿は、以下の教材をベースに現代的な解釈を加えて構成しました。

🔗 出典：東京大学「Pythonプログラミング入門」4-3. ディレクトリと木構造

📚 ディレクトリと木構造：用語完全網羅リスト

講義資料（4-3）に登場するすべての概念と記号を網羅的に解説します。

■ ディレクトリ (Directory) / フォルダ (Folder)

ファイルを格納するための「入れ物」です。OS上では一般に階層的に管理されており、ファイルをひとまとめにする機能から「フォルダ」とも呼ばれます。

■ 階層構造 (Hierarchical Structure)

ディレクトリの中にさらにディレクトリが含まれる、多層的な管理方式のことです。情報の所在を整理するために用いられます。

■ ワーキングディレクトリ (Working Directory)

プログラムが実行されている「起点となる場所」のこと。WindowsやmacOSでファイルをクリックしてアプリを起動した場合、そのファイルがある場所が自動的に設定されます。

■ カレント（ワーキング）ディレクトリ (Current Directory)

「現在の」作業ディレクトリを指します。Pythonでは os.getcwd() で確認でき、os.chdir() で変更することが可能です。

■ パス (Path)

ファイルやディレクトリの場所を指し示す「経路」の表記です。各ディレクトリを区切り文字（通常は /）で繋いで記述します。

■ . (ドット1つ：カレントディレクトリ記号)

現在のディレクトリそのものを表す特別な記号です。相対パスの先頭に自動的に補われることが多いですが、明示的に ./sample.txt と書くこともできます。

■ .. (ドット2つ：親ディレクトリ記号)

現在のディレクトリから見て「1段上のディレクトリ」を指す記号です。../text/novel.txt のように、階層を遡ってから別の子ディレクトリへ移動する際などに使用します。

■ 絶対パス (Absolute Path)

ルートディレクトリ（最上位 /）から全ての経路を記述する方法です。実行環境のカレントディレクトリがどこであっても、常に同じ場所を指し示します。

■ 相対パス (Relative Path)

カレントディレクトリを起点として目的地の経路を記述する方法です。パスが / 以外から始まる場合は、自動的に相対パスとして扱われます。

■ 木構造 / ツリー (Tree Structure)

データの階層関係を、1つの根から枝分かれする木に見立てた表現。ディレクトリ構造そのもののモデルです。

■ ノード (Node)

木構造を構成する各要素（ファイルやディレクトリ）の総称です。

■ 根 / ルート (Root)

木構造の最上位、つまり全ての階層の頂点にあるノードです。パス表記では / で表されます。

■ 葉 / リーフ (Leaf)

木構造の末端にあり、それ以上の子を持たないノード。ファイルシステムの例では「ファイル」がこれに該当します。

■ 親 (Parent) / 子 (Child)

包含関係において、外側のディレクトリが「親」、その中に含まれるディレクトリやファイルが「子」となります。

■ 兄弟 / シブリング (Sibling)

同じ親ディレクトリを共有しているノード（ファイルやディレクトリ）同士の関係です。

■ 祖先 (Ancestor) / 子孫 (Descendant)

親子関係を再帰的に適用した概念です。親の親は「祖先」、子の子は「子孫」と呼ばれます。

■ 入れ子構造 (Nested Structure)

ある構造の中に同じ形式の構造が含まれていること。Pythonでは「辞書の中に辞書を入れる」ことで、ディレクトリの木構造をプログラム上で表現できます。

※上図のように、ディレクトリを木構造として捉えることで、複雑なファイル配置も論理的に整理できるようになります。

出典：東京大学 Pythonプログラミング入門 4-3. ディレクトリと木構造

© 2024 ディレクトリ構造学習ガイド