Python 業務自動化 | ファイル操作自動化：フォルダ内のファイル一覧を取得する

Python自動化の基礎として、フォルダ内のファイル一覧を取得する意味を理解する

Pythonでファイル操作自動化を学び始めると、ファイルを作成する、削除する、コピーする、移動する、名前や拡張子を変更する、特定拡張子だけ取得するといった処理を少しずつ身につけていきます。その中で、ほぼすべてのファイル自動化の出発点になるのが「フォルダ内のファイル一覧を取得する」という考え方です。

初心者の方は、ファイル操作というと最初から特定のファイル名を手で指定することが多いです。もちろん練習段階ではそれでも構いません。しかし実際の自動化では、毎回同じ名前のファイルがあるとは限りません。日付付きファイルが増えていくこともありますし、処理対象が毎回変わることもあります。そのたびに1件ずつ手でファイル名を指定していたら、自動化の意味が薄れてしまいます。

そこで必要になるのが、フォルダの中に何が入っているかをプログラムに一覧で取得させる考え方です。たとえば、フォルダ内の全ファイルを順番に処理したり、その中から特定拡張子だけを選んだり、件数を数えたりできます。つまり、ファイル一覧取得は単なる確認ではなく、その後のあらゆる自動化につながる非常に重要な基礎です。

この記事では、Python自動化の中でもファイル操作自動化の基礎として、「フォルダ内のファイル一覧を取得する」方法をプログラミング初心者向けにステップバイステップで詳しく解説します。なぜ必要なのか、どうやって取得するのか、どんな考え方が必要なのか、どんな点に注意するべきかまで、例題やコード例やテンプレートを交えながら、できるだけかみ砕いて説明します。

まず理解したい、フォルダ内のファイル一覧を取得するとは何か

一覧取得とは、フォルダの中にある名前をまとめて受け取ることです

フォルダ内のファイル一覧を取得するとは、あるフォルダの中に入っているファイルやフォルダの名前を、まとめてプログラムで受け取ることです。たとえば、あるフォルダに sales.csv、memo.txt、image.png があれば、それらの名前を一覧として取得できます。

初心者の方はまず、「一覧取得とは、フォルダの中身をプログラムで見える形にすること」だと理解すると分かりやすいです。人がエクスプローラーやFinderで見ている情報を、Python側でも扱えるようにするイメージです。

一覧を取ること自体が目的ではなく、その後の処理の入口になります

一覧を取得するだけでは、まだ自動化は完了していません。本当に大切なのは、その一覧を使って次の処理へつなげることです。たとえば、順番に読み込む、条件に合うファイルだけ選ぶ、件数を数える、バックアップする、移動する、といった処理です。つまり、一覧取得は「自動化の入口」と考えると理解しやすいです。

なぜフォルダ内のファイル一覧を取得するのか

手で1件ずつ指定しなくてよくなるからです

毎回ファイル名を手で書く方法では、対象が増えるほど手間が増えますし、入力ミスも起こりやすくなります。そこで一覧取得を使えば、フォルダに入っているものをまとめて扱えるため、より自動化らしい処理ができるようになります。

ファイル数や対象が毎回変わっても対応しやすくなるからです

自動化では、今日のファイル数と明日のファイル数が同じとは限りません。ファイル名も毎回変わることがあります。そうした変化へ対応しやすくするためにも、フォルダ内の一覧をその都度取得する考え方が重要です。

条件付き処理の土台になるからです

以前学びやすい「特定拡張子だけ取得する」処理も、まずは一覧があってこそ成り立ちます。つまり、フォルダ内のファイル一覧取得は、その後の選別や繰り返し処理の土台になります。

Pythonでフォルダ内の一覧を取得する基本

os.listdir() を使うのが基本です

Pythonでフォルダの中身を一覧で取得するときは、os モジュールの listdir() を使うのが基本です。

import os

# 現在のフォルダの一覧を取得します
file_list = os.listdir(".")

# 取得結果を表示します
print(file_list)

import os

# 現在のフォルダの一覧を取得します
file_list = os.listdir(".")

# 取得結果を表示します
print(file_list)

このコードでは、. で表される現在のフォルダの中身を一覧として取得しています。初心者の方はまず、「一覧取得には os.listdir() を使う」と覚えると分かりやすいです。

os.listdir() は名前の一覧をリストで返します

ここで大切なのは、os.listdir() が返すのは「名前の一覧」だということです。つまり、結果はリストとして受け取れます。リストである以上、繰り返し処理したり、件数を数えたり、条件で絞り込んだりできます。初心者の方は、この「一覧はリストとして扱える」という感覚を身につけることが重要です。

最初に覚えたい、一覧取得の流れ

まず対象フォルダを決める

一覧取得では、最初に「どのフォルダの中身を見たいのか」を決める必要があります。現在のフォルダでもよいですし、特定のフォルダパスでも構いません。初心者の方はまず現在のフォルダから始めると理解しやすいです。

次に、一覧を変数へ入れる

取得した一覧は、リストとして変数へ保存します。こうすることで、あとから何度でも使えるようになります。

最後に、一覧を確認したり順番に処理したりする

取得しただけでは終わりではありません。中身を表示して確認したり、for 文で順番に処理したりするところまでが大切です。

例題1 現在のフォルダの一覧を表示する

最初に作るべき基本例です

まずは、現在のフォルダにある名前をそのまま表示するシンプルな例を見てみます。

import os

# 現在のフォルダの一覧を取得します
file_list = os.listdir(".")

# 取得した一覧をそのまま表示します
print(file_list)

import os

# 現在のフォルダの一覧を取得します
file_list = os.listdir(".")

# 取得した一覧をそのまま表示します
print(file_list)

このコードはとても基本的ですが、「フォルダの中身をまとめて受け取れる」という感覚をつかむのに重要です。初心者の方はまず、結果がリストで返ってくることに慣れることが大切です。

例題2 一覧を1件ずつ見やすく表示する

繰り返し処理と組み合わせると理解しやすいです

一覧をそのまま表示すると、慣れないうちは少し見づらく感じることがあります。そこで、1件ずつ順番に表示すると分かりやすくなります。

import os

# 現在のフォルダの一覧を取得します
file_list = os.listdir(".")

# 一覧を1件ずつ表示します
for file_name in file_list:
    # ファイル名を表示します
    print(file_name)

import os

# 現在のフォルダの一覧を取得します
file_list = os.listdir(".")

# 一覧を1件ずつ表示します
for file_name in file_list:
    # ファイル名を表示します
    print(file_name)

この形にすると、繰り返し処理の練習にもなります。初心者の方は、「一覧を取得して終わり」ではなく、「順番に使う」流れまでセットで理解すると応用しやすいです。

例題3 特定フォルダの一覧を取得する

現在のフォルダ以外も扱えることを知っておくと便利です

実際の自動化では、現在のフォルダ以外を対象にすることもよくあります。たとえば、data フォルダの中身を見たい場合です。

import os

# 対象フォルダのパスです
folder_path = "data"

# 指定フォルダの一覧を取得します
file_list = os.listdir(folder_path)

# 一覧を1件ずつ表示します
for file_name in file_list:
    # ファイル名を表示します
    print(file_name)

import os

# 対象フォルダのパスです
folder_path = "data"

# 指定フォルダの一覧を取得します
file_list = os.listdir(folder_path)

# 一覧を1件ずつ表示します
for file_name in file_list:
    # ファイル名を表示します
    print(file_name)

この例では、data フォルダの中身を取得しています。初心者の方は、現在のフォルダだけでなく「別フォルダも指定できる」と理解しておくと、自動化のイメージが広がります。

例題4 一覧の中から特定拡張子だけを取り出す

一覧取得と条件選別を組み合わせるのが実用的です

一覧取得だけで終わらず、その中から目的のファイルだけを取り出す形は非常によく使います。たとえば、CSVファイルだけを取得する場合です。

import os

# 対象フォルダのパスです
folder_path = "."

# フォルダ内の一覧を取得します
file_list = os.listdir(folder_path)

# CSVファイルだけを入れるリストです
csv_files = []

# 一覧を順番に確認します
for file_name in file_list:
    # .csv で終わるファイルだけを対象にします
    if file_name.endswith(".csv"):
        # CSVファイルだけをリストへ追加します
        csv_files.append(file_name)

# 取得したCSVファイル一覧を表示します
print(csv_files)

import os

# 対象フォルダのパスです
folder_path = "."

# フォルダ内の一覧を取得します
file_list = os.listdir(folder_path)

# CSVファイルだけを入れるリストです
csv_files = []

# 一覧を順番に確認します
for file_name in file_list:
    # .csv で終わるファイルだけを対象にします
    if file_name.endswith(".csv"):
        # CSVファイルだけをリストへ追加します
        csv_files.append(file_name)

# 取得したCSVファイル一覧を表示します
print(csv_files)

この例まで理解できると、一覧取得がその後のファイル操作自動化にどうつながるかがかなり見えてきます。

フォルダ内一覧取得で特に注意したい重要ポイント

os.listdir() はファイルだけでなくフォルダ名も含むことがあります

これは非常に重要です。os.listdir() は、そのフォルダの中にある「名前」を返します。つまり、ファイルだけでなくサブフォルダの名前も含まれることがあります。初心者の方は、一覧を取ったら全部ファイルだと思い込みやすいですが、実際にはそうとは限りません。

そのため、「ファイルだけ処理したいのか」「フォルダも含めて扱いたいのか」を意識する必要があります。これは後の学習でとても大切になります。

存在しないフォルダを指定するとエラーになることがあります

対象フォルダの名前やパスを間違えると、一覧取得はできません。そのため、初心者の方はまず「本当にそのフォルダがあるか」を意識することが大切です。特に、実行場所とフォルダの位置関係がずれていると混乱しやすいです。

取得結果の順番は必ずしも思った通りとは限りません

一覧の順番は、見た目の並びと完全に一致するとは限りません。初心者のうちは「なんとなく名前順に返る」と思いがちですが、必要ならあとで並び替える考え方も重要になります。まずは、「取得順は自動で都合よく整っているとは限らない」と知っておくと役立ちます。

ファイルだけを対象にしたいときの考え方も重要です

os.path.isfile() と組み合わせると安全です

一覧の中にはフォルダ名も含まれることがあるため、本当にファイルだけを対象にしたいなら確認を入れると安全です。

import os

# 対象フォルダのパスです
folder_path = "."

# フォルダ内の一覧を取得します
file_list = os.listdir(folder_path)

# 一覧を順番に確認します
for file_name in file_list:
    # フルパスを作成します
    full_path = os.path.join(folder_path, file_name)

    # ファイルだけを対象にします
    if os.path.isfile(full_path):
        # ファイル名を表示します
        print(file_name)

import os

# 対象フォルダのパスです
folder_path = "."

# フォルダ内の一覧を取得します
file_list = os.listdir(folder_path)

# 一覧を順番に確認します
for file_name in file_list:
    # フルパスを作成します
    full_path = os.path.join(folder_path, file_name)

    # ファイルだけを対象にします
    if os.path.isfile(full_path):
        # ファイル名を表示します
        print(file_name)

この形にすると、「一覧の中からファイルだけを使う」という考え方がはっきりします。初心者の方は最初から完璧に覚えなくても大丈夫ですが、一覧取得ではこうした確認が大切だと知っておく価値があります。

初心者向けの実用テンプレート

ここまでの内容を踏まえると、フォルダ内のファイル一覧を取得する基本テンプレートは次のようになります。

import os

# 対象フォルダのパスです
folder_path = "."

# フォルダ内の一覧を取得します
file_list = os.listdir(folder_path)

# 一覧を順番に確認します
for file_name in file_list:
    # フルパスを作成します
    full_path = os.path.join(folder_path, file_name)

    # ファイルだけを対象にします
    if os.path.isfile(full_path):
        # ファイル名を表示します
        print(file_name)

import os

# 対象フォルダのパスです
folder_path = "."

# フォルダ内の一覧を取得します
file_list = os.listdir(folder_path)

# 一覧を順番に確認します
for file_name in file_list:
    # フルパスを作成します
    full_path = os.path.join(folder_path, file_name)

    # ファイルだけを対象にします
    if os.path.isfile(full_path):
        # ファイル名を表示します
        print(file_name)

このテンプレートはとても基本的ですが、ファイル操作自動化の出発点として非常に重要です。初心者の方は、まずこの形をしっかり理解し、その後で特定拡張子だけ取得する処理や、読み込み・コピー・移動へ発展させるとよいです。

初心者がよくつまずくポイント

一覧の中身が全部ファイルだと思い込む

これは非常によくあるつまずきです。実際にはフォルダ名も混ざることがあります。そのため、必要ならファイルかどうかを確認することが重要です。

実行場所と対象フォルダの位置関係が分からなくなる

. は現在のフォルダを意味しますが、どこが現在のフォルダなのかを意識していないと、「思った場所の中身が出てこない」ということが起きやすいです。初心者の方は特に、実行中の場所を意識する習慣が大切です。

一覧を取っただけで満足してしまう

一覧取得は重要ですが、本当の目的はその後の処理です。表示だけして終わりではなく、そのあとで選別したり、読み込んだり、整理したりする流れへつなげる意識が大切です。

セキュリティと安全性の観点からの注意

対象フォルダを広げすぎないことが重要です

情報セキュリティや安全運用の観点では、必要以上に広い範囲を対象にしないことが大切です。たとえば、どこに何があるかよく分からない大きなフォルダ全体をいきなり一覧取得し、そのまま処理対象にするのは危険です。初心者のうちは、まず練習用フォルダを作り、その中だけを対象にするのがおすすめです。

外部から受け取ったパスをそのまま信用しないことも大切です

対象フォルダのパスを外部入力から受け取る場合は、想定外の場所を見に行ってしまう可能性があります。初心者の段階では、まず自分で決めた固定フォルダを安全に扱うことから始めるのがよいです。これは情報セキュリティの基本である「外部入力をそのまま信用しない」という考え方にもつながります。

学習を進めるときのおすすめの順番

フォルダ内のファイル一覧を取得する技術を無理なく身につけるには、次の順番で進めると理解しやすいです。

• まずは os.listdir() の基本を覚える
• 次に現在のフォルダの一覧を表示する
• その次に for 文で1件ずつ扱う
• 別フォルダを指定して一覧を取得する
• os.path.isfile() でファイルだけを絞る
• 最後に特定拡張子だけ取得する処理へ発展させる

この順番で進めると、単なる一覧表示ではなく、実用的なファイル自動化の入口として自然に理解しやすくなります。

まとめ

Python自動化におけるファイル操作自動化の基礎として、「フォルダ内のファイル一覧を取得する」ことは非常に重要です。ファイル名を手で1つずつ指定するのではなく、フォルダの中身をまとめて取得することで、件数が変わっても柔軟に対応できるようになり、その後の読み込み、選別、移動、削除などの自動化につなげやすくなります。

基本は、os.listdir() で一覧を取得し、必要に応じて for 文で順番に処理することです。ただし、本当に大切なのは、「一覧にはファイルだけでなくフォルダ名も含まれることがある」と理解し、必要なら os.path.isfile() で絞ることです。ここを意識するだけで、コードの安全性と分かりやすさが大きく変わります。

初心者の方はまず、現在のフォルダの一覧を表示するところから始め、その後で1件ずつ表示する、別フォルダを指定する、特定拡張子だけを選ぶ、という順番で少しずつ発展させると理解しやすいです。

フォルダ内のファイル一覧を取得する技術は、一見すると地味な基本操作に見えるかもしれません。しかし実際には、ファイル操作自動化の入口であり、その後の多くの処理を支えるとても重要な土台です。だからこそ、最初の段階で丁寧に理解しておく価値があります。