この記事では.gitignoreファイルの使用についてわかりやすく説明します。Gitプロジェクトにおいて、.gitignoreファイルは無視すべきファイルやディレクトリを指定する重要な役割を果たします。
.gitignore ファイル
このファイルは Git プロジェクトにおいて重要な役割を果たします。
.gitignore の基本
- これはプレーンテキストファイルで、Git が無視すべきファイルやディレクトリを指定します。
- プロジェクトのルートディレクトリに配置します(例:
/Homepages/.gitignore
)。
主な用途
- 一時ファイルの除外
- ビルド成果物の除外
- 秘密情報(パスワード、APIキーなど)を含むファイルの除外
- IDE や OS が生成する不要なファイルの除外
基本的な書き方
# コメントはハッシュで始める
*.log # すべての .log ファイルを無視
build/ # build ディレクトリ全体を無視
secret.txt # 特定のファイルを無視
パターンの例
*
: 0文字以上の任意の文字列?
: 任意の1文字[abc]
: a, b, c のいずれか1文字!
: 無視しないパターン(除外の除外)
よく使われる記述例
# Node.js
node_modules/
npm-debug.log
# Python
*.pyc
__pycache__/
# IDE
.vscode/
.idea/
# OS generated
.DS_Store
Thumbs.db
適用範囲
.gitignore
は、そのファイルが置かれたディレクトリとそのサブディレクトリに適用されます。
既に追跡されているファイル
.gitignore
は新しく追加されるファイルにのみ効果があります。- 既に追跡されているファイルを無視するには、追跡を解除する必要があります:
git rm --cached <file>
グローバル .gitignore
- システム全体で適用したい場合は、グローバルな
.gitignore
も設定できます。
注意点
.gitignore
自体は通常バージョン管理に含めます。- プロジェクト固有の無視ルールと開発者個人の設定を分けることをお勧めします。
利点
- リポジトリを清潔に保つ
- 不要なファイルのコミットを防ぐ
- チーム全体で一貫した除外ルールを共有できる
まとめ
.gitignore
を適切に設定することで、プロジェクトの管理が容易になり、不要なファイルによる混乱を避けることができます。
プロジェクトの性質や使用する技術に応じて、適切な .gitignore
ファイルを作成することが重要です。