GitHubでフォルダを作成するのは難しくありませんが、ちょっとしたコツがあります。プロジェクトを整理しようとして、一部のフォルダが表示されないことに気づいたことがあるなら、おそらくGitHubが空のディレクトリを認識していないことが原因でしょう。少し面倒ですが、驚くことではありません。Gitはフォルダではなくファイルを追跡するからです。つまり、フォルダを残しておきたい場合は、その中に少なくとも1つのファイルが必要です。多くの人は`.gitkeep`や`README.md`というファイルを挿入します。こうすることで、フォルダはリポジトリ内で常に表示されます。Webインターフェースを使用する場合でも、Gitを使ってローカルに作成する場合でも、これらのちょっとしたコツを知っておくことで、面倒な作業を1つか2つ省くことができます。
GitHub でフォルダーを作成する方法は?
GitHubウェブサイトでフォルダを作成する
これは簡単な調整に最も簡単な方法です。複雑なコマンドは必要ありません。リポジトリにアクセスして、インターフェースを操作してみてください。GitHubにログインしたら、フォルダを追加したいリポジトリに移動してください。
- ブラウザで GitHub リポジトリを開きます。
- [ファイルの追加] ボタンをクリックし、[新しいファイルの作成] を選択します。
- ファイル名フィールドにフォルダ名を入力し、スラッシュを追加します(例:
docs/README.md
)。これにより、GitHub は「docs」という名前のフォルダを作成し、その中にファイルを追加します。 - ファイルに何らかのコンテンツ(簡単な行でも可)を追加します。GitHub は空のフォルダーを認識しないため、これが必要です。その後、[新しいファイルをコミット]をクリックします。
すると、新しいフォルダが瞬時に作成され、その中にファイルが1つ追加されます。設定によっては、すべてが表示されるまでに1~2回更新が必要になる場合がありますが、これは正常です。フォルダ内にREADME.mdなどのファイルを追加することが、フォルダを有効に保つ秘訣です。
Gitを使用してローカルリポジトリにフォルダを作成する
自分のマシンで作業したい場合は、ローカルにフォルダを作成してGitHubにプッシュすると、より細かな制御が可能になります。手順は以下のとおりです。
- ターミナルまたはコマンド プロンプト (Windows の場合は PowerShell) を開きます。
- プロジェクト ディレクトリに移動します:
cd path/to/your-repo
。 - 新しいフォルダーを作成します:
mkdir your-folder-name
。 - そのフォルダー内に、空にならないようにファイルを追加します
touch your-folder-name/README.md
(または、Windows で Git Bash を使用していない場合は、テキスト ファイルを手動で作成します)。 - 変更を追加してコミットします。
git add.
git commit -m "Add new folder"
- すべてを押し上げます:
git push
この方法を使うと、複数のネストされたフォルダを作成したり、プッシュ前に必要に応じてファイルを追加したりといった柔軟性が得られます。ただし、Gitは空のフォルダを追跡しないため、プッシュする際には常に少なくとも1つのファイルが存在する必要があります。
また、興味があったり問題に遭遇したりした場合に備えて、リモート ブランチで作業しているときにマージの競合が発生することがある点に注意してください。そのため、Git で競合を解決する方法を知っておくと、面倒なことを避けることができます。
GitHub ではなぜフォルダー内にファイルが必要なのでしょうか?
これはGitの典型的な癖です。Gitはフォルダではなくファイルを追跡するように設計されているため、フォルダが空の場合は無視されます。フォルダを常に表示しておくために、開発者は通常、.gitkeep
や のようなプレースホルダファイルを挿入しますREADME.md
。少し安っぽいですが、うまく機能します。
よくある質問
スラッシュを含む完全なパスを入力するだけです: src/components/button/index.js
GitHub はそれを認識し、必要なフォルダーが存在しない場合はすべて作成します。
いいえ。Gitは空のフォルダを認識しないんです。まずファイルを追加しないと、「どのフォルダ?」って感じになってしまいます。
ちょっとした編集をするだけなら、ウェブ経由でも問題ありません。しかし、大規模なプロジェクトや複数のネストされたフォルダを扱う必要がある場合は、ローカルで作成してからプッシュする方がスムーズです。ターミナルやIDEで何が起こっているか確認できます。
はい、ファイルを新しいフォルダに移動して、古いフォルダを削除してからプッシュするだけです。GitHubには直接「フォルダ名を変更」するボタンがないので、これが回避策です。
まとめ
一度コツをつかめば、GitHubでフォルダを作るのはそれほど難しくありません。Webインターフェースは素早く、ローカルで作成すれば大規模なプロジェクトでもよりスムーズに作業できます。ただし、必ずフォルダ内にファイルを追加してください。そうしないと、フォルダがリポジトリから消えてしまいます。少し奇妙に感じるかもしれませんが、これがGitの仕組みです。空のディレクトリは許可されません。
まとめ
- スラッシュを使用して新しいファイルを作成し、 Web 経由でフォルダーを作成します。
- を使用してローカルにフォルダーを作成しmkdir、 を使用してプッシュしgit addますgit push。
- GitHub でファイルが表示されるようにするには、フォルダー内に少なくとも 1 つのファイルを常に追加します。
- GitHub は空のフォルダーを直接サポートしていないため、それに応じて計画を立ててください。
まとめ
これで誰かの辛い時間を少しでも節約できれば嬉しいです。ちょっとしたミスでつまずいてしまうこともあるのですが、これで分かりました。どんな方法でも、ファイルが入っていることを確認しておけば大丈夫です。頑張ってください。お役に立てれば幸いです!