【Windows】ディレクトリ構造をツリー形式でテキスト出力するコマンドの活用手順

日々の業務でファイルやフォルダの構成を把握したい時、あるいはその構造をチームメンバーや顧客と共有したい時があるでしょう。手動で構造を書き出すのは時間と手間がかかり、ミスも発生しがちです。

Windowsに標準搭載されている「treeコマンド」を活用すれば、指定したディレクトリの構造をツリー形式で簡単にテキスト出力できます。

この記事では、treeコマンドの基本的な使い方から、ファイルへの出力、さらに応用的なオプションの活用方法まで、Windows 11を基準に詳しく解説します。

treeコマンドとは何か、その機能と活用場面

treeコマンドは、WindowsのコマンドプロンプトやPowerShellで実行できる標準のコマンドラインツールです。指定したディレクトリの下にあるサブディレクトリやファイルを、階層構造を示すツリー形式で表示する機能を持っています。

このコマンドは、特に以下のような場面で役立ちます。

プロジェクトのファイル構成を共有する際、視覚的に分かりやすい資料を作成できます。また、システムの特定のフォルダ構造を調査したり、誤って作成された不要なディレクトリを探し出したりする際にも効果的です。

複雑なファイルパスを口頭や文章で説明するよりも、ツリー形式で提示することで、情報の正確性と伝達効率が格段に向上します。

treeコマンドの基本的な動作原理

treeコマンドは、指定されたパスから再帰的にディレクトリをたどり、見つけたすべてのサブディレクトリとファイルの一覧を作成します。その後、それらを視覚的に分かりやすいインデントされた形式で整形し、標準出力に表示します。

この処理は、ファイルシステムを読み取るだけであり、ファイルの変更や削除といった書き込み操作は行いません。そのため、安心して利用できるコマンドです。

表示されるツリーは、テキストベースのグラフィックで構成され、ディレクトリ間の親子関係や階層の深さが一目で理解できます。

ディレクトリ構造をツリー形式でテキスト出力する手順

treeコマンドを使用してディレクトリ構造をテキスト出力する具体的な手順を説明します。Windows 11での操作を基準としますが、Windows 10でも同様に実行できます。

コマンドプロンプトまたはPowerShellの起動

1. スタートメニューを開く
   タスクバーのスタートボタンを右クリックするか、WindowsキーとXキーを同時に押します。
2. ターミナルを選択する
   表示されたメニューから「ターミナル 管理者」を選択します。これにより、管理者権限でコマンドプロンプトまたはPowerShellが起動します。

現在のディレクトリの構造を表示する

1. コマンドを入力する
   コマンドプロンプトまたはPowerShellのウィンドウで、「tree」と入力し、Enterキーを押します。
2. 結果を確認する
   現在いるディレクトリのサブディレクトリ構造がツリー形式で表示されます。

特定のディレクトリの構造を表示する

1. コマンドを入力する
   特定のディレクトリの構造を表示するには、「tree <パス>」と入力します。例えば、デスクトップの構造を表示したい場合は「tree C:\Users\<ユーザー名>\Desktop」と入力します。
2. 結果を確認する
   指定したパスのディレクトリ構造がツリー形式で表示されます。

ファイル名も表示する

1. 「/F」オプションを使用する
   ディレクトリだけでなく、その中のファイル名も表示するには、「tree /F」と入力します。特定のパスのファイル名も表示したい場合は、「tree <パス> /F」と入力します。
2. 結果を確認する
   各ディレクトリの下に、そのディレクトリに含まれるファイルもツリーの一部として表示されます。

テキストファイルに出力する

1. リダイレクト機能を使用する
   表示結果をテキストファイルに保存するには、「>」記号を使って出力先ファイルを指定します。例えば、「tree > C:\Users\<ユーザー名>\Desktop\tree_output.txt」と入力します。
2. ファイルを開いて確認する
   指定したパスに「tree_output.txt」というファイルが作成され、その中にツリー構造のテキストが保存されます。メモ帳などのテキストエディタで開いて内容を確認できます。

表示文字をASCII形式にする

1. 「/A」オプションを使用する
   ツリーの表示に使われる線が、環境によっては正しく表示されない場合があります。その際は、「tree /A」オプションを使うと、ASCII文字のみでツリーが描画され、文字化けを防げます。
2. 他のオプションと組み合わせる
   「tree /F /A > output.txt」のように、他のオプションやファイル出力と組み合わせて使用できます。

treeコマンド利用時の注意点と失敗例

treeコマンドは便利ですが、使用方法によっては意図しない結果になったり、エラーが発生したりする場合があります。よくある注意点と失敗例、およびその対処法を理解しておきましょう。

出力文字コードによる文字化け

日本語のファイル名やディレクトリ名を含むツリー構造をテキストファイルに出力した場合、文字コードの問題で文字化けが発生する場合があります。

原因: コマンドプロンプトの既定の文字コードがShift-JISであるのに対し、出力先のテキストエディタがUTF-8として開こうとするなど、文字コードの不一致が原因です。

対処法:

1. 「/A」オプションの使用: ツリーの描画文字をASCIIに限定することで、線による文字化けは防げます。ファイル名自体の文字化けには効果がありません。
2. chcpコマンドで文字コードを変更する: コマンドプロンプトで「chcp 65001」と入力して文字コードをUTF-8に変更してからtreeコマンドを実行し、テキストファイルに出力します。その後、テキストエディタでUTF-8として開きます。元の文字コードに戻すには「chcp 932」と入力します。
3. PowerShellの利用: PowerShellは既定でUTF-8を扱うため、文字化けしにくい傾向があります。「tree /F | Out-File -Encoding utf8 <ファイル名>」のように、Out-Fileコマンドレットと組み合わせることで確実にUTF-8で出力できます。

アクセス権不足で一部のディレクトリが表示されない

treeコマンドを実行しても、一部のディレクトリやファイルが表示されないことがあります。これは、アクセス権の不足が原因である場合が多いです。

原因: 実行しているユーザーアカウントに、特定のディレクトリやファイルへの読み取り権限がないためです。システムフォルダなどではよく発生します。

対処法:

1. 管理者として実行する: コマンドプロンプトやPowerShellを「管理者として実行」することで、ほとんどのアクセス権の問題は解決します。
2. 対象パスを変更する: アクセス権のないフォルダは避けて、表示したい範囲を狭めることも有効です。

出力結果が長大になりすぎる

非常に深い階層を持つディレクトリや、大量のファイルを含むディレクトリに対してtreeコマンドを実行すると、出力結果が膨大になることがあります。画面に収まらない、またはファイルサイズが大きくなりすぎる問題です。

原因: コマンドの実行範囲が広すぎることが原因です。

対処法:

1. 対象パスを限定する: treeコマンドの引数で、より具体的なパスを指定し、表示範囲を狭めます。
2. 特定の階層までで停止するオプションを使用する: treeコマンドには直接的な階層指定オプションはありませんが、PowerShellのGet-ChildItemコマンドレットと組み合わせることで、特定の階層までの表示が可能です。例えば、「Get-ChildItem -Path <パス> -Recurse -Depth 2」のように「-Depth」オプションで階層数を指定できます。
3. lessコマンドでページ表示する: 出力結果を画面で確認したい場合、「tree | less」と入力すると、1画面ずつ表示され、上下にスクロールして確認できます。「q」キーで終了します。

Windows 10とWindows 11での違い

treeコマンド自体の機能やオプションは、Windows 10とWindows 11で大きな違いはありません。どちらのOSでも同様の操作でツリー形式の出力を得られます。

ただし、Windows 11では既定のターミナルアプリが「Windows Terminal」に変更されており、コマンドプロンプトやPowerShellを起動する際のインターフェースが異なります。機能的な差異ではないため、操作に影響はありません。

treeコマンドの主なオプション比較

treeコマンドには、出力形式を制御するためのいくつかのオプションがあります。ここでは、主要なオプションとその機能について比較します。

オプション	機能	使用例
なし	サブディレクトリのみを表示	tree
/F	ディレクトリとファイルの両方を表示	tree /F
/A	ASCII文字を使用してツリーグラフィックを表示	tree /A
/L	大文字と小文字を区別してファイル名を表示(既定)	tree /L

まとめ

treeコマンドを活用することで、Windowsの複雑なディレクトリ構造を視覚的に分かりやすいツリー形式で瞬時に把握し、テキストファイルとして出力できます。

この機能は、プロジェクトのドキュメント作成やシステム構成の分析、情報共有の効率化に大きく貢献します。

今回解説した「/F」や「/A」といったオプション、文字コードの変更方法、そしてPowerShellとの連携を試して、treeコマンドを業務に役立ててください。