最初のGitリポジトリを作成する
はじめに
Gitの基本と用語を理解したところで、最初のGitリポジトリを作成する時が来ました。このチュートリアルでは、新しいGitリポジトリの初期化、ディレクトリ構造の理解、バージョン管理のための最初のプロジェクトのセットアップ方法を説明します。
このチュートリアルの終わりには、完全に機能するGitリポジトリを持ち、プロジェクトファイルの追跡を開始する方法を理解することができます。
前提条件
このチュートリアルを始める前に、以下のことを確認してください：
- システムにGitがインストールされていること（Gitのインストールとセットアップ）
- Gitの概念の基本的な理解（Gitの基本と用語の理解）
- お好みのテキストエディタまたはIDE
- コマンドラインの基本的な知識
Gitリポジトリを作成する2つの方法
Gitリポジトリを作成するには主に2つの方法があります：
- 既存のディレクトリに新しいリポジトリを初期化する
- リモートの場所から既存のリポジトリをクローンする
このチュートリアルでは最初の方法に焦点を当てます。クローンについては、リモートリポジトリに関する後のチュートリアルで説明します。
方法1：新しいリポジトリを初期化する
ステップ1：プロジェクトディレクトリを作成する
まず、プロジェクト用の新しいディレクトリを作成します：
# 新しいディレクトリを作成
mkdir my-first-git-project
# ディレクトリに移動
cd my-first-git-projectステップ2：Gitリポジトリを初期化する
プロジェクトディレクトリでGitを初期化します：
git init次のような出力が表示されるはずです：
Initialized empty Git repository in /path/to/my-first-git-project/.git/何が起きたのか？
- Gitはプロジェクトフォルダに隠れた
.gitディレクトリを作成しました - この
.gitディレクトリにはすべてのGitメタデータとオブジェクトデータベースが含まれています - あなたのディレクトリは今Gitリポジトリになりました（ただし空です）
ステップ3：リポジトリの作成を確認する
ディレクトリでGitが機能していることを確認します：
git status次のように表示されるはずです：
On branch main
No commits yet
nothing to commit (create/copy files and use "git add" to track)これにより以下のことが確認できます：
mainブランチにいる- まだコミットが行われていない
- 追跡されているファイルがない
.gitディレクトリについて理解する
.gitディレクトリにはすべてのGitリポジトリデータが含まれています。その構造を見てみましょう：
ls -la .git/次のようなディレクトリとファイルが表示されます：
config- リポジトリの設定description- リポジトリの説明（GitWebで使用）HEAD- 現在のブランチを指すhooks/- Gitフック（スクリプト）のディレクトリinfo/- 追加のリポジトリ情報objects/- Gitオブジェクトデータベースrefs/- 参照（ブランチ、タグ）
重要：何をしているのか正確に理解していない限り、.gitディレクトリ内のファイルを手動で編集しないでください！
最初のファイルを作成する
ステップ1：READMEファイルを作成する
プロジェクト用のREADMEファイルを作成します：
echo "# My First Git Project" > README.mdまたはテキストエディタで作成します：
# My First Git Project
This is my first project using Git version control.
## Features
- Learning Git basics
- Understanding version control
- Building good development habits
## Getting Started
This project demonstrates basic Git workflow and commands.ステップ2：追加ファイルを作成する
プロジェクトをより興味深くするために、いくつかのファイルを追加で作成しましょう：
# シンプルなPythonスクリプトを作成
cat > hello.py << 'EOF'
#!/usr/bin/env python3
def greet(name):
"""Return a greeting message."""
return f"Hello, {name}!"
if __name__ == "__main__":
print(greet("World"))
EOF
# シンプルなテキストファイルを作成
echo "This is a sample text file for Git practice." > sample.txt
# プロジェクト設定ファイルを作成
cat > config.json << 'EOF'
{
"project": "my-first-git-project",
"version": "1.0.0",
"author": "Your Name",
"description": "Learning Git version control"
}
EOFステップ3：リポジトリのステータスを確認する
Gitが何を認識しているか確認しましょう：
git status次のように表示されるはずです：
On branch main
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
README.md
config.json
hello.py
sample.txt
nothing added to commit but untracked files present (use "git add" to track)出力の理解：
Untracked files- Gitが現在追跡していないファイル- Gitは
git addを使用してこれらのファイルの追跡を開始することを提案しています
Gitにおけるファイルの状態
Gitはファイルを異なる状態に分類します：
1. 未追跡（Untracked）
- 作業ディレクトリに存在するがGitによって追跡されていないファイル
- 新しいファイルはこのカテゴリに分類されます
2. 追跡済み（Tracked）
Gitが認識しているファイルで、以下の状態があります：
- 未変更（Unmodified） - 前回のコミット以降変更がない
- 変更済み（Modified） - 変更されたがステージングされていない
- ステージング済み（Staged） - 次のコミットのために変更がマークされている
基本的なGit設定（オプション）
コミットを行う前に、あなたの身元情報でGitを設定するとよいでしょう：
# 名前とメールを設定（グローバルに設定していない場合）
git config user.name "Your Name"
git config user.email "[email protected]"
# 現在の設定を表示
git config --listリポジトリ固有の設定
このリポジトリに固有の設定を行うこともできます：
# リポジトリ固有の設定を行う
git config user.name "Project Specific Name"
git config user.email "[email protected]"
# リポジトリの設定を表示
git config --local --list.gitignoreファイルの作成
Gitが無視すべきファイルを指定する.gitignoreファイルを作成します：
cat > .gitignore << 'EOF'
# Ignore compiled Python files
*.pyc
__pycache__/
# Ignore temporary files
*.tmp
*.temp
# Ignore log files
*.log
# Ignore IDE files
.vscode/
.idea/
*.swp
*.swo
# Ignore OS-specific files
.DS_Store
Thumbs.db
EOFなぜ.gitignoreを使用するのか？
- 一時ファイルが追跡されるのを防ぐ
- リポジトリをきれいに保つ
git statusのノイズを減らす- 機密データの誤ったコミットを防ぐ
Gitリポジトリ構造の理解
あなたのプロジェクトは現在この構造になっています：
my-first-git-project/
├── .git/ # Gitリポジトリデータ（隠しフォルダ）
├── .gitignore # 無視するファイル
├── README.md # プロジェクトドキュメント
├── config.json # 設定ファイル
├── hello.py # Pythonスクリプト
└── sample.txt # サンプルテキストファイルリポジトリのステータスを再度確認する
リポジトリがどのように見えるか確認しましょう：
git status次のように表示されるはずです：
On branch main
No commits yet
Untracked files:
(use "git add <file>..." to include in what will be committed)
.gitignore
README.md
config.json
hello.py
sample.txt
nothing added to commit but untracked files present (use "git add" to track)リポジトリ作成のベストプラクティス
1. 早期に初期化する
多くのコードを書いた後ではなく、プロジェクトの最初からGitを使い始めましょう。
2. 良いREADMEを作成する
常に以下を説明するREADMEファイルを含めましょう：
- プロジェクトの目的
- インストール/実行方法
- 貢献方法
3. 最初から.gitignoreを使用する
不要なファイルを追跡しないように、早い段階で.gitignoreを設定しましょう。
4. 意味のあるディレクトリ名を選ぶ
プロジェクトディレクトリには説明的な名前を使用しましょう。
5. リポジトリのルートをきれいに保つ
ルートディレクトリに多すぎるファイルを置かないようにしましょう。
避けるべき一般的なミス
1. ホームディレクトリでGitを初期化しない
# これはやめましょう
cd ~
git init2. .gitディレクトリを削除しない
.gitを削除するとすべてのGit履歴が破壊されます。
3. 別のGitリポジトリ内でGitを初期化しない
これは混乱と競合を引き起こす可能性があります。
4. 大きなバイナリファイルを追跡しない
大きなファイルには代わりにGit LFSを使用しましょう。
方法2：ファイルがある状態で初期化する
すでにディレクトリにファイルがある場合、そこでGitを初期化できます：
# 既存のプロジェクトに移動
cd existing-project
# Gitを初期化
git init
# ファイルは未追跡状態になり、追加する準備ができています
git status一般的な問題のトラブルシューティング
問題：「Not a git repository」
解決策：正しいディレクトリにいることとgit initを実行したことを確認してください。
問題：Permission Denied
解決策：ファイルのアクセス権を確認し、ディレクトリに書き込み権限があることを確認してください。
問題：Repository Already Exists
解決策：「Reinitialized existing Git repository」と表示される場合、Gitは既存の.gitディレクトリを検出しています。
まとめ
最初のGitリポジトリを正常に作成しました！以下のことを達成しました：
- プロジェクトディレクトリを作成し、Gitを初期化した
- .gitディレクトリの構造と目的を理解した
- README、コード、設定を含むプロジェクトファイルを作成した
- 不要なファイルを除外するために**.gitignoreを設定**した
- Gitにおけるファイルの状態（追跡済みvs未追跡）について学んだ
- リポジトリ用にGitを設定した
使用した主要コマンド：
git init- 新しいリポジトリを初期化するgit status- リポジトリの状態を確認するgit config- Git設定を構成する
現在のリポジトリの状態：
- ✅ リポジトリが初期化された
- ✅ ファイルが作成された
- ✅ .gitignoreが設定された
- ⏳ ファイルは未追跡状態（ステージングの準備ができている）
次のステップ
ファイルを持つリポジトリができたので、基本的なGitワークフローを学ぶ準備ができました：
- ファイルをステージングエリアに追加する（git add）
- 変更をコミットする（git commit）
- リモートリポジトリにプッシュする（git push）
続きは：基本的なGitワークフロー：追加、コミット、プッシュ