.gitignoreの作成

リポジトリを初期化したら、最初に.gitignoreファイルを作成します。不要なファイルが誤ってコミットされることを防ぐため、他のファイルをコミットする前に設定しておくのが一般的です。

Visual Studio Codeのエクスプローラーで右クリックし、「新しいファイル」を選択して.gitignoreを作成します。

git-practice/
└── .gitignore  ← このファイルを作成

作成したファイルに以下の内容を記述して保存します。

# Python
__pycache__/
*.pyc
venv/

# 環境変数
.env

# IDE
.vscode/
.idea/

# OS
.DS_Store

それぞれの記述内容を確認しましょう。

記述 説明 除外する理由
__pycache__/ Pythonのキャッシュフォルダ 実行時に自動生成されるため
*.pyc Pythonのキャッシュファイル 実行時に自動生成されるため
venv/ 仮想環境フォルダ 大量のファイルを含み、requirements.txt で管理するため
.env 環境変数ファイル APIキーやDB接続情報などの機密情報が含まれるため
.vscode/ Visual Studio Codeの設定 個人の開発環境に依存する設定のため
.idea/ JetBrains系エディタの設定 個人の開発環境に依存する設定のため
.DS_Store macOSが自動生成するファイル 開発とは無関係なため
💡 ポイント
.gitignore はプロジェクトの最初に作成するのがベストプラクティスです。後から .gitignore に追加しても、すでにGitで追跡されているファイルは自動的には除外されません。最初に適切な .gitignore を用意しておくことで、不要なファイルがリポジトリに混入するのを防げます。

.gitignoreを作成したら、Gitに変更を記録します。Gitでは、変更をいきなり記録(コミット)するのではなく、まず git add で記録したいファイルをステージングエリアに追加し、次に git commit で確定するという2段階の手順を踏みます。

git add .gitignore

git add はファイルをステージングエリアに追加するコマンドです。ステージングエリアとは「次のコミットに含めるファイルの一覧」のことです。続けてコミットを実行します。

git commit -m "chore: .gitignoreを追加"

実行すると以下のように表示されます。

[main (root-commit) xxxxxxx] chore: .gitignoreを追加
 1 file changed, 11 insertions(+)
 create mode 100644 .gitignore

-m オプションの後にコミットメッセージを指定します。コミットメッセージは「どのような変更を行ったか」を簡潔に記述します。出力の 1 file changed, 11 insertions(+) は、1つのファイルが変更され、11行が追加されたことを示しています。