GitHub Desktopで初めてリポジトリをCloneする
ブラウザー認証後にリモートリポジトリをローカルフォルダーへ複製する手順です。開始位置、設定値、完了確認、問題時の見直し方まで具体的に説明します。
公開 · 更新 · FaultNote 編集方針
この記事が役立つ人・作業前の準備
- GitHub Desktopを初めて使う人
- GitHub Desktopで初めてリポジトリをCloneする操作を安全に確認したい人
用意するもの
- GitHubアカウント、アクセス権のあるリポジトリ、空の保存先親フォルダーを用意する。
アカウントと対象リポジトリを確認する
GitHubアカウント、アクセス権のあるリポジトリ、空の保存先親フォルダーを用意する。
Clone先の空フォルダーを選ぶ
GitHub Desktopで［File］>［Options］>［Accounts］からGitHub.comへサインインし、ブラウザー認証を完了する。
［File］>［Clone repository］>［GitHub.com］で対象を検索して選ぶ。［Local path］に新しい専用フォルダーとなる場所を指定し［Clone］を押す。
- Cloneで所有者とリポジトリ名を選ぶ
- 既存作業のないローカル保存先を指定する
READMEとブランチを確認する
［Repository］>［Show in Explorer］でファイルを開き、［View on GitHub］でリモート名を照合する。Current branchも既定ブランチか確認する。
- READMEと現在のブランチを確認する
権限エラーとローカル変更を切り分ける
一覧にない場合はGitHub上の権限、組織SSO認可、ログイン先を確認する。URLタブから正確なURLを指定する方法もある。
既存の非空フォルダーをLocal pathに選ばない。Clone直後にPublish repositoryを押す必要はなく、秘密情報をコミットしない。
- アクセス権とログインアカウントを照合する
CloneとForkの違いを先に決める
自分のPCで読むだけならCloneでローカルコピーを作れます。他人のプロジェクトへ変更を提案し、自分のリモートコピーが必要ならForkを検討します。CloneしただけでGitHub上に別のリポジトリが作られるわけではありません。対象の所有者名とリポジトリ名を確認し、似た名前の別プロジェクトを取得しないようにします。非公開リポジトリの場合は、取得するアカウントへ権限があることも確認します。
教材を読む目的なら、Clone後にREADMEと指定ファイルを開くだけで開始できます。実行が必要ならREADMEに従って環境を用意します。課題を編集する前にブランチを確認し、変更後は差分で何を変えたか読みます。取得の成功、実行の成功、提出の完了をそれぞれ別の結果として確認してください。
取得後はREADMEとブランチを確認する
取得が終わったらエクスプローラーでフォルダーを開き、READMEと実行前の準備を読みます。リポジトリがあることとアプリが実行できることは別で、依存関係や設定ファイルが必要な場合があります。GitHub Desktopの現在のブランチを確認し、変更前に目的のブランチへ切り替えます。外部コードのスクリプトを内容確認なしで起動せず、秘密情報を含む設定を共有フォルダーへ置かないでください。
小さな変更でローカル状態を確かめる
自分の練習リポジトリでREADMEへ一行追加し、Changesに対象ファイルだけが現れるか確認します。差分を読み、意図しない設定や生成ファイルが入っていないことを確認してください。Commitはローカルの履歴記録であり、Pushはリモートへ送る別操作です。練習の変更を戻す場合は対象ファイルの差分だけを確認して戻し、他の未保存・未コミット作業をまとめて破棄しないでください。
表は横にスクロールできます →
| 確認した状態 | 次に行う操作 | 完了の目安 |
|---|---|---|
| 一覧に対象がない | ログイン先とリポジトリ権限を確認する | 正しい所有者と名前を選べる |
| 保存先を使えない | 既存ファイルを避け新しい保存先を選ぶ | 他の作業を壊さず取得できる |
| 実行できない | READMEの依存関係と準備を確認する | Cloneと実行環境を分けて説明できる |
注意点・利用条件
- 既存の非空フォルダーをLocal pathに選ばない。Clone直後にPublish repositoryを押す必要はなく、秘密情報をコミットしない。
よくある質問
GitHub Desktopで目的の項目が見つからない場合は？
一覧にない場合はGitHub上の権限、組織SSO認可、ログイン先を確認する。URLタブから正確なURLを指定する方法もある。
GitHub Desktopで初めてリポジトリをCloneする操作で特に注意する点は？
既存の非空フォルダーをLocal pathに選ばない。Clone直後にPublish repositoryを押す必要はなく、秘密情報をコミットしない。
Cloneすると自動で公開されますか？
ローカルコピーの取得であり、新しい公開リポジトリを作る操作ではありません。Publish、Push、Forkは別の目的を持つ操作です。非公開資料を扱う場合は保存先の共有状態にも注意し、確認のために公開ボタンを押さないでください。
Clone直後に変更が出る場合は？
Changesのファイルと差分を確認します。ツールが生成した設定や改行差などの可能性を調べ、原因が分からないまま全部コミットしないでください。自分の必要な変更と生成物を分け、破棄する場合も対象を確認して他の作業を残します。
出典・確認日
情報確認日：。仕様・操作方法・価格などの確認に使用した出典を掲載しています。適用条件や現在の情報は各リンク先で確認してください。
関連する活用ガイド
- Windows 11：仮想デスクトップで仕事ごとの画面を分ける
- Windowsの操作をまとめて効率化するPowerToys入門
- Thunderbirdで複数メールを一つのアプリにまとめる
- Firefoxのコンテナーとリーダービューを使い分ける
- Rufusで公式ISOから起動USBを作る
- スマート アプリ コントロールでアプリが起動できないとき：個別の例外は用意されていない