GitHub Desktopの使い方入門
GitHub Desktopは、Gitの操作を画面上で進めたい人に向いた入口です。ただし、ボタンを押す前にrepo、branch、差分、公開範囲、Secretsの有無を確認する流れは変わりません。
このページでわかること
- clone、commit、push、pullの基本の流れがわかる
- 変更ファイルとdiffを見てからcommitする癖を作る
- 公開前にSecretsや個人情報の混入を確認する
まず確認すること
- 作業対象repoとbranchが合っているか見る
- changed filesとdiffに想定外のファイルがないか見る
- push前に公開URLやPRで見える範囲を考える
やってはいけないこと
- 差分を見ずにcommitやpushを進める
- Secretsや.envを含むファイルをそのまま入れる
- mainへ直接入れる前提で作業を固定する
安全寄りに進める手順
- 対象のrepo、branch、PR、Actions runを確認する。
- Secrets、APIキー、token、.env、個人情報が差分やログに出ていないか見る。
- 必要な場合は値を停止または再発行し、影響範囲を整理する。
- 変更は小さなbranchとPRに分け、CIとreviewで確認する。
CodexやAI作業時の注意
AIに作業を渡す時は、対象ファイル、触らないファイル、確認項目を明記します。認証情報や実際のキー値は本文、Issue、PR説明、ログ、レポートに残さないようにします。
公式情報で確認する領域
Actions、Secrets、PR、repository visibility、workflow permissionsは仕様が変わることがあります。実作業前にはGitHub Docsで最新の説明を確認してください。
画面から使う場合に向く作業
コマンドを打つ方法と比べて、画面から使うほうが向く場面があります。
- 変更内容を見比べる — 差分が読みやすく表示されます
- 一部だけ選んで反映する — 行単位で選べます
- 操作を覚えていない時 — 選択肢が見えます
2番目が実際に効く場面です。作業の途中で複数の変更が混ざった時、関係のあるものだけを選んでまとめられます。後から履歴を読む人にとって分かりやすくなります。
画面からでは難しい作業
逆に、次はコマンドのほうが確実です。
- 細かい条件を付けた操作
- 複数の手順をまとめて実行する
- 手順を記録して再現する
どちらか一方に決める必要はありません。普段は画面、込み入った作業だけコマンド、という使い分けが現実的です。同じ場所を両方から操作しても問題ありません。
最初につまずくところ
使い始めで止まりやすい箇所を先に挙げておきます。
- どのアカウントで入っているか — 個人と仕事で分けている場合は要確認
- 手元とサーバー側のどちらが新しいか — 取り込みと送信の順番
- 変更が競合した時 — 慌てて上書きしない
3番目で焦らないでください。競合は、両方の変更を確認してから決める場面です。片方を機械的に選ぶと、他の人の変更を消します。分からない場合は、その場で決めずに相手に確認してください。
複数の端末で使う場合
同じ作業を複数の端末で行う場合、次に注意してください。
- 作業を始める前に取り込む — 別の端末で進めた分を反映する
- 作業を終えたら送信する — 手元に置いたままにしない
- 途中の状態で切り替えない
3番目で事故が起きます。片方の端末に未送信の変更を残したまま別の端末で作業すると、後で食い違います。切り替える前に、送信できる形にしておいてください。