Go言語でディレクトリ内のファイル一覧を取得する方法について解説

2025-04-15更新日: 2025-04-15

このブログ記事は、Go言語でディレクトリ内のファイル一覧を取得する方法を分かりやすく解説します。

実際のコード例を交えながら、シンプルな手法で効率的なファイル操作の方法を説明します。

開発環境が整った方はすぐに実践できる内容です。

SEO対策にも配慮して記述しています。

目次から探す

ディレクトリとファイル一覧取得の基本
- ファイルシステムの基礎
- Go言語でのディレクトリ操作概要
基本的な一覧取得処理の実装例
- 全体の処理フロー
- ディレクトリ読み込みに用いる関数
ファイル一覧のフィルタリング方法
- 特定拡張子ファイルの抽出方法
- サブディレクトリの再帰的処理
実装時の注意点
- エラーハンドリングの考慮事項
- パフォーマンス最適化の留意点
応用例と活用方法
- コマンドラインツールとしての実装例
- 機能拡張による応用事例
まとめ

Go言語を使った求人

読み込み中…

ディレクトリとファイル一覧取得の基本

ファイルシステムの基礎

ファイルシステムは、コンピュータ上でデータやプログラムを整理・管理する仕組みです。

ディレクトリ(フォルダ)やファイルは、ツリー状に整理され、ユーザーやアプリケーションが効率よくアクセスできるようになっています。

OSごとに若干の違いはありますが、基本的な概念は共通ですので、Go言語を使った処理にも応用できます。

Go言語でのディレクトリ操作概要

Go言語はシンプルな文法でファイルシステムへのアクセスが可能です。

標準ライブラリを利用することで、ディレクトリ内のファイル一覧取得やファイル操作など、多くの処理が容易に実装できるよう設計されています。

標準ライブラリの利用方法

Goの標準ライブラリには、システムリソースにアクセスするためのパッケージが用意されています。

特に、ファイルやディレクトリの操作に関しては、osパッケージとio/ioutil(最近ではosやioパッケージで代替)が頻繁に使用されます。

これにより、新たなライブラリを導入することなく、簡単にディレクトリ操作が可能です。

filepathとosパッケージの特徴

filepathパッケージは、OSに依存しないパス名操作を提供しており、例えばパスの結合や分解を行う際に役立ちます。

一方、osパッケージはファイルやディレクトリの実際の入出力操作を実装しており、ディレクトリを開く、内容を読み込む、ファイル情報を取得するなどの機能が揃っています。

これらのパッケージを組み合わせることで、プラットフォーム間で一貫したファイル操作が実現できます。

基本的な一覧取得処理の実装例

全体の処理フロー

ディレクトリ一覧取得の基本的な処理フローは、次のような手順で進みます。

取得対象のディレクトリパスを指定する
指定したディレクトリを開く
ディレクトリ内のエントリ(ファイルやサブディレクトリ)の一覧を読み込む
読み込んだ一覧に対して必要な処理(表示やフィルタリング)を実行する
エラーハンドリングを適切に行い、処理の失敗を検出・対応する

main関数での実装例

以下は、指定したディレクトリのファイル一覧を取得して表示するシンプルな実装例です。

package main
import (
	"fmt"
	"log"
	"os"
)
func main() {
	// 対象ディレクトリのパスを指定
	dirPath := "./sample_directory"
	// ディレクトリ内のエントリを取得
	entries, err := os.ReadDir(dirPath)
	if err != nil {
		// エラー発生時はログに出力して終了
		log.Fatal("ディレクトリ読み込みエラー:", err)
	}
	// エントリ一覧を表示
	for _, entry := range entries {
		fmt.Println(entry.Name())
	}
}

file1.txt
file2.go
subdir

エラーハンドリングの実装方法

エラーハンドリングは、プログラムの信頼性を高めるために重要です。

上記の例では、ディレクトリの読み込み時にエラーが発生した場合、log.Fatalを呼び出しプログラムを即座に終了しています。

開発環境によっては、エラー内容に応じて再試行やフォールバック処理を実装することが検討される場合もあります。

ディレクトリ読み込みに用いる関数

os.Openとos.ReadDirの使い方

Goでは、os.Openを用いてファイルもしくはディレクトリを開くことができますが、ディレクトリ一覧を取得する場合はos.ReadDirの方が直感的で使いやすいです。

例えば、os.ReadDirはディレクトリ内の各エントリをfs.DirEntry型で返し、その中から名前や種類を取得できます。

以下に簡単な使用例を示します。

package main
import (
	"fmt"
	"log"
	"os"
)
func main() {
	// 対象ディレクトリのパスを指定
	path := "./sample_directory"
	// os.ReadDirを使いディレクトリを読み込む
	entries, err := os.ReadDir(path)
	if err != nil {
		log.Fatal("ディレクトリの読み込みに失敗:", err)
	}
	// 各エントリの名前とディレクトリかどうかを表示
	for _, entry := range entries {
		if entry.IsDir() {
			fmt.Println("ディレクトリ:", entry.Name())
		} else {
			fmt.Println("ファイル:", entry.Name())
		}
	}
}

ファイル: file1.txt
ファイル: file2.go
ディレクトリ: subdir

ファイル一覧のフィルタリング方法

特定拡張子ファイルの抽出方法

取得したファイル一覧から特定の拡張子(例えば、.goや.txtなど)を持つファイルのみを抽出するには、filepath.Ext関数を併用すると便利です。

手順としては、各ファイル名から拡張子を取得し、目的の拡張子と一致するかチェックします。

条件に合致した場合のみ、処理対象として扱います。

リストやスライスを使い、抽出した結果を格納する実装例は以下のようになります。

サブディレクトリの再帰的処理

再帰処理の実装例

サブディレクトリも含め、全てのファイルを取得するためには再帰処理が有効です。

以下は、指定ディレクトリ内のすべてのファイルを再帰的に列挙するサンプルコードです。

package main
import (
	"fmt"
	"log"
	"os"
	"path/filepath"
)
// listFilesは指定ディレクトリ内のファイルパスを再帰的に取得する関数です
func listFiles(dir string) ([]string, error) {
	var files []string
	// Walk関数を使い、ディレクトリ全体を巡回
	err := filepath.Walk(dir, func(path string, info os.FileInfo, err error) error {
		if err != nil {
			// エラーが発生した場合はエラーを返す
			return err
		}
		// ディレクトリでなければファイルとして追加
		if !info.IsDir() {
			files = append(files, path)
		}
		return nil
	})
	return files, err
}
func main() {
	baseDir := "./sample_directory"
	fileList, err := listFiles(baseDir)
	if err != nil {
		log.Fatal("ファイル一覧取得に失敗:", err)
	}
	// ファイル一覧を表示
	for _, filePath := range fileList {
		fmt.Println(filePath)
	}
}

./sample_directory/file1.txt
./sample_directory/file2.go
./sample_directory/subdir/file3.txt

実装時の注意点

エラーハンドリングの考慮事項

実装時には、必ずエラーが発生する可能性のある処理に対して適切なエラーハンドリングを施す必要があります。

特に、ディレクトリが存在しない場合やアクセス権限が不足している場合、プログラムは予期せぬ動作をする恐れがあります。

エラー内容をログに記録することで、トラブルシュートがしやすくなります。

代表的なエラーケースへの対策

代表的なエラーには、以下のようなケースがあります。

存在しないディレクトリを指定した場合

→ エラーチェック後、ユーザーに正しいパスを促す。

アクセス権限が不足している場合

→ アクセス権の変更や、適切なエラーメッセージを表示する。

ファイル名の取得に失敗した場合

→ 失敗した場合でも、全体の処理が継続できるような仕組みを検討する。

パフォーマンス最適化の留意点

大量のファイルが存在するディレクトリの場合、処理効率が重要です。

再帰処理や、複数のファイルを同時に読み込む際には、性能に影響を与える可能性があります。

適切なバッファリングや並列処理を検証することで、高速化が期待できます。

大量ファイル処理時の対応策

大量のファイルを扱う場合、以下の点に留意してください。

ディスクの入出力負荷を考慮し、処理を分割する
並列処理を活用し、複数のスレッドでファイル操作を行う
メモリ使用量を監視し、必要に応じて一時的な結果をディスクに保存する

応用例と活用方法

コマンドラインツールとしての実装例

Go言語を用いて、ディレクトリのファイル一覧を取得する機能をコマンドラインツールとして実装することが可能です。

ユーザーからディレクトリパスをコマンドライン引数で受け取り、結果を標準出力に表示する方式が一般的です。

基本機能の実装手法

以下は、コマンドライン引数でディレクトリパスを指定し、ファイル一覧を表示するシンプルなサンプルコードです。

package main
import (
	"flag"
	"fmt"
	"log"
	"os"
)
func main() {
	// コマンドライン引数からディレクトリパスを取得
	dirPath := flag.String("dir", ".", "一覧を取得するディレクトリパス")
	flag.Parse()
	entries, err := os.ReadDir(*dirPath)
	if err != nil {
		log.Fatal("ディレクトリの読み込みに失敗:", err)
	}
	// 取得結果を表示
	for _, entry := range entries {
		fmt.Println(entry.Name())
	}
}