何が起きたか

Gitで空のディレクトリを残す方法として、ディレクトリ内に「.gitkeep」を作る手順がgistに掲載されている。空ディレクトリを検索し、各ディレクトリにファイルを作成するコマンドと、`.gitignore`で「.gitkeep」を除外対象から外す設定例を示した。

詳細

空ディレクトリの検索とファイル作成には、`find . -type d -empty -not -path './.git*' -exec touch {}\/\.gitkeep \;`というコマンドを掲載している。`.gitignore`に`*~`と`.*`を記載している場合は、`!.gitkeep`を追加して「.gitkeep」を無視しないようにする手順も示した。

Key Facts

gistは、Gitではファイル単位で管理するため空のディレクトリは管理対象にならないと説明している。[1]
空ディレクトリ内に「.gitkeep」を作成する方法を紹介している。[1]
`.gitignore`で「.*」を無視する設定には、`!.gitkeep`を加える例を示している。[1]

本紙の見方

このgistが扱うのは、Gitの管理対象をファイルとして扱う際に、空のディレクトリをそのまま残せないという運用上の問題である。提示された対応は、空ディレクトリに「.gitkeep」というファイルを置き、ディレクトリを含む作業ツリーの状態をファイルによって表すものだ。特別な機能を持つファイルとしてではなく、空の場所を記録するための目印として説明されている点が要点となる。 手順は二段階に分かれる。まず`find`で空ディレクトリを探してファイルを作る。次に、`.gitignore`がドットで始まるファイルを無視する設定になっている場合、除外ルールの例外として`!.gitkeep`を記す。したがって、ファイルを作るだけでは足りず、無視設定との組み合わせも確認する必要がある。提示されたコマンドは`./.git*`に一致するパスを検索対象から外しており、作業ツリー内の空ディレクトリをまとめて処理する形だ。 この方法が示すのは、ディレクトリ自体ではなく、そこに置いたファイルを通じて空の場所を扱う運用である。チーム内で同じ構成を維持したい場合、`.gitkeep`の配置を作業手順に含めることが選択肢になる。ただし、gistはこの方法を「よいらしい」と紹介しており、`.gitkeep`に特別な意味があるか、どのプロジェクトで採用すべきかまでは説明していない。ファイル名や運用ルールを統一する必要があるかも、提示内容だけからは判断できない。 今後確認すべきなのは、実際のリポジトリで無視ルールがどのように適用されるか、また空ディレクトリを残す目的に対して目印ファイルが必要かどうかである。gistには、複数人での運用、既存の無視設定との優先関係、作成後の確認方法は記載されていない。そのため、コマンドを使う場合は、対象ディレクトリと`.gitignore`の設定を個別に確かめる必要がある。

なぜ重要か

空のディレクトリをGitの管理対象として残したい場合、このgistは「.gitkeep」を置く手順を示している。`.gitignore`でドットファイルを無視する設定を使っている場合は、例外指定も必要だとしており、ファイル作成と無視ルールの両方を確認する内容である。