Softrime Lab

学習記事一覧 · バージョン管理ツール学習

付録A GitHub Desktop 実践手順

授業や、現場での新人オンボーディングの両方で使える手順です。

ドラッグ＆ドロップ方式がおすすめ

学習時や現場での導入では、ドラッグ＆ドロップ方式の方が圧倒的にトラブルが少ないです。

理由

学習者や新人はすでに

  • Visual Studioでプロジェクトを作っている
  • フォルダ構造ができている

だから「New Repository → そこにコピー」は手順が増えます。その結果

  • コピー場所を間違える
  • フォルダを二重に作る
  • プロジェクトが壊れる

という事故がよく起きます。

一番簡単な方法

Visual Studioで作ったフォルダを、そのままGit管理にすることです。

つまりフォルダ → GitHub Desktop にドラッグです。

トラブルが少ない手順

① Visual Studioでプロジェクト作成

例：

MiniPractice
 ├ Program.cs
 ├ Day1.cs
 ├ Day2.cs
 └ MiniPractice.csproj

② GitHub Desktopを起動

③ プロジェクトフォルダを追加

方法A（ドラッグ）：MiniPractice フォルダを GitHub Desktop にドラッグ

方法B（パス指定）：メニュー「File」→「Add Local Repository」でフォルダを選択

④ リポジトリを作成

「このディレクトリはGitリポジトリではないようです」と表示された場合、「create a repository here」（ここにリポジトリを作成）のリンクをクリックします。

「Create a New Repository」ダイアログが開きます。

  • 名前とパスを確認する
  • 「Git ignore」を「Visual Studio」に設定する（bin、obj、.vs が除外され、ビルド成果物や個人設定がリポジトリに含まれなくなる）
  • 「Create Repository」をクリックする

⑤ 初回コミット（自動）

リポジトリ作成後、初回コミット（Initial commit）は自動で実行されます。「Committed just now Initial commit」と表示されれば完了です。

※フォルダに既存のファイル（Program.cs など）がある場合、それらは自動で初回コミットに含まれます。

⑥ push

右上の「Publish repository」を押して、GitHub に公開します。

別パターン：手動で初回コミットする場合

「Add repository」で既存の Git リポジトリを追加した場合など、ファイルが「Changes」に表示される状態になることがあります。その場合は、以下を手動で行います。

  1. 左下にコメント（例：初回コミット）を書く
  2. 「Commit to main」をクリック
  3. 右上の「Publish repository」を押す

この方法のメリット

  1. 手順が少ない（フォルダ → ドラッグ → リポジトリ作成 → Publish。初回コミットは自動）
  2. Visual Studioの構造が壊れない（コピー操作がないので安全）
  3. 初心者が理解しやすい（「このフォルダをGitで管理する」という概念が分かりやすい）

GitHub Desktopのインストール

https://desktop.github.com/

インストール後、GitHubアカウントでログインします。