【VSCode】Gitを使うための初期設定と基本操作

Windows環境のVSCodeでGitを使用する際、毎回調べがちな初期設定と基本操作、Windows特有の注意点をまとめた。

PCの買い替えや、Windowsでの開発環境の再構築時にそのまま使える。

１．事前準備：Git for Windowsの導入

Windows環境でGitを動かすためのコア。

• Git for Windows 公式 からインストーラを入手。
• 設定はすべてデフォルト（Next連打）でインストール完了させる。

２．初回のみ実行するグローバル設定

VSCodeの組み込みターミナル（PowerShell等）を開き、以下のコマンドを順に実行。

① ユーザー識別情報

# ユーザー名（半角英数字）
[root@almalinux ~]# git config --global user.name "ユーザー名"

# メールアドレス
[root@almalinux ~]# git config --global user.email "メールアドレス"

# ユーザー名（半角英数字）
[root@almalinux ~]# git config --global user.name "ユーザー名"

# メールアドレス
[root@almalinux ~]# git config --global user.email "メールアドレス"

② 改行コード自動変換（Windows必須設定）

Windows（CRLF）とMac/Linux（LF）の改行コード混在トラブルを防止する。
「チェックアウト時にCRLFへ変換、コミット時にLFへ自動逆変換」させる設定。

[root@almalinux ~]# git config --global core.autocrlf true

[root@almalinux ~]# git config --global core.autocrlf true

③ 設定確認コマンド

[root@almalinux ~]# git config --list

[root@almalinux ~]# git config --list

３．ローカルリポジトリの初期化

新規プロジェクトでGit管理をスタートする手順。

1. VSCodeで対象プロジェクトのフォルダを開く。
2. ショートカット Ctrl + Shift + G で「ソース管理」パネルを開く。
3. 「リポジトリを初期化」 ボタンをクリック。
   • ⇒ フォルダ直下に .git（隠しフォルダ）が生成され、追跡開始。

４．日常の基本ルーティン（GUI操作）

コマンドを打たず、VSCodeの左サイドバー「ソース管理」パネルからマウスで完結させる手順。

• Step 1: ステージング（変更の追加）
  • 変更ファイル一覧の右側にある 「＋」ボタン をクリック（＝コミット対象に指定）。
• Step 2: コミット（ローカルリポジトリ）
  • 上部の「メッセージ」欄に変更内容（例: feat: add index.html）を入力。
  • 「コミット」ボタン をクリック。
• Step 3: プッシュ（リモートリポジトリ）
  • GitHub等のリモート連携後は、「変更の同期」ボタン をクリックで送信完了。

５．Windows特有のTips・トラブルシューティング

• パスの区切り文字
  • Windows標準の \（バックスラッシュ）ではなく、Gitコマンド内では /（スラッシュ）を使用する。
• パネルが行方不明時
  • Ctrl + Shift + G ですぐにソース管理画面を呼び出す。
• コマンドパレットの活用
  • Ctrl + Shift + P で git と入力すれば、ほぼすべてのGit操作がコマンド候補として検索可能。